登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go os.ReadDir 怎么按文件大小筛选并稳定排序

来源:17golang原创

时间:2026-09-07 02:23:48 282浏览 收藏

需要在目录里找出超过某个大小的文件时,os.ReadDir 已经足够:先读取 []os.DirEntry,排除目录项,再调用 Info() 得到文件大小,最后用“大小 + 文件名”两个键排序。这样不会把目录本身的元数据大小混进结果,也不会因为同大小文件的原始顺序变化而产生抖动。

核心写法是:筛选阶段只保留普通文件,排序阶段先比较 Size,大小相同再比较 Name。第二个比较键才是结果稳定的关键。
要点速览
  • os.ReadDir 返回的目录项默认按文件名排列,但按大小重排后必须自己定义同值规则。
  • DirEntry.IsDir() 负责排除目录,DirEntry.Info() 才能取得 FileInfo.Size()
  • 生产代码建议把大小保存为 int64,并用文件名作为次排序键。

先区分文件项、目录项和文件大小

os.ReadDir 返回的是目录项,不是已经打开的文件。目录项可以先用 IsDir 判断类型;只有需要元数据时,再调用 Info。对普通文件来说,FileInfo.Size() 才是适合拿来比较的字节数。目录项的大小受文件系统实现影响,不应当当作目录内所有文件的总大小。

下面的结果结构只留下后续展示和排序所需的字段。遇到某个条目的元数据读取错误时直接返回上下文错误,调用方可以知道是哪个文件出了问题。

Go os.ReadDir 通过 DirEntry、Info 和 FileInfo.Size 筛选普通文件的静态结构图
图1:目录项先经过类型判断与元数据读取,再进入普通文件集合;目录不会被当作文件大小参与筛选。

用 os.ReadDir 读取后只保存可排序字段

package main

import (
    "fmt"
    "os"
)

// SizedFile 是筛选后的最小结果,避免排序时反复读取文件元数据。
type SizedFile struct {
    Name string
    Size int64
}

func filesAtLeast(dir string, minBytes int64) ([]SizedFile, error) {
    entries, err := os.ReadDir(dir)
    if err != nil {
        return nil, fmt.Errorf("读取目录 %q: %w", dir, err) // 保留路径上下文
    }

    result := make([]SizedFile, 0, len(entries))
    for _, entry := range entries {
        if entry.IsDir() {
            continue // 目录大小不代表目录内容大小
        }

        info, err := entry.Info()
        if err != nil {
            return nil, fmt.Errorf("读取 %q 的元数据: %w", entry.Name(), err)
        }
        if !info.Mode().IsRegular() {
            continue // 这里的边界只接受普通文件
        }
        if info.Size() >= minBytes {
            result = append(result, SizedFile{
                Name: entry.Name(),
                Size: info.Size(),
            })
        }
    }
    return result, nil
}

这里的阈值使用 >=,表示“至少这么大”;如果业务说的是“超过”,改成 > 即可。int64 能覆盖常见文件大小,调用时也不要把 MB 直接当作字节传入,例如 20 MiB 应写成 20 × 1024 × 1024

按大小排序时把同值文件名写进比较器

读取结果默认按文件名排序,并不等于按文件大小排序。重排时可以用大小降序,把较大的文件放在前面;当大小相同,再按文件名升序。这个次键让结果顺序与目录枚举的偶然细节脱钩,适合日志列表、清理候选和批处理预览。

package main

import "sort"

func sortBySize(files []SizedFile) {
    sort.SliceStable(files, func(i, j int) bool {
        if files[i].Size != files[j].Size {
            return files[i].Size > files[j].Size // 主键:大小降序
        }
        return files[i].Name 
Go 文件大小筛选后以大小主键和文件名次键稳定排序的静态结构图
图2:大小是主排序键,文件名是同值时的次排序键,排序结果因此可重复。
判断点推荐做法原因
目录项类型先用 IsDir,再读取 Info避免把目录元数据混入文件结果
大小字段保存 int64FileInfo.Size 保持一致
同大小文件比较 Name消除并列项的顺序歧义

迁移检查:错误、符号链接与稳定性

如果旧代码使用 ioutil.ReadDir,迁移到 os.ReadDir 时要注意返回类型已经变成 DirEntry。不要直接调用不存在的 Size 方法,而应按需调用 Info。上面的实现还主动跳过非普通文件;如果业务需要跟随符号链接,应先定义链接策略,再决定是否用独立的 os.Stat 获取目标信息。

最后检查三个边界:目录不存在或无权限时保留原始错误;空目录返回空切片而不是伪造一条结果;同一目录重复调用时,排序规则必须只依赖大小和文件名。这样即使底层目录项读取顺序发生变化,展示和后续批处理也不会悄悄换序。

常见问题

为什么不能直接对 DirEntry 调用 Size?

DirEntry 只描述目录中的一项,大小属于文件信息,需要先调用 Info() 获取 FileInfo

同样大小的文件一定会保持原顺序吗?

不要依赖原顺序。把文件名明确写成次排序键,才能让结果在重复读取时保持确定。

目录也要统计时怎么处理?

目录大小不是其内容总和。若要统计目录占用,应递归读取子目录并定义符号链接、权限错误和重复路径的处理规则,不能复用这里的普通文件筛选逻辑。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>