Go os.ReadDir 返回的目录项为什么要再调用 Info：类型判断、排序与错误边界

目录扫描代码最容易出现的浪费，是拿到每个 DirEntry 后立刻调用 Info，但实际只想知道“它是不是目录”。os.ReadDir 已经把目录项包装成了可以先判断、后深读的接口：Type 和 IsDir 负责快速分流，只有需要大小、权限或修改时间时才读取 FileInfo。

先用 IsDir、Type 完成目录项分类，再按业务需要调用 Info；不要把一次可能失败的元数据读取当成每个条目的必经步骤。

接口目标：一次扫描到底需要哪些信息

假设一个清理任务只需要找出一级子目录，最小需求是“名称 + 是否目录”。这时为每个条目读取大小、权限和时间，既增加系统调用机会，也让一个失效条目拖住整次扫描。

如果页面要显示文件大小，或者清理规则要根据修改时间筛选，Info 才是必要的第二阶段。接口的关键取舍是把“分类”和“取详情”分开，而不是追求对每个条目都拿到完整元数据。

调用方需求：IsDir、Type 和 Info 分别解决什么

只判断目录时优先 IsDir

entry.IsDir() 直接表达业务意图，适合目录列表、递归入口和清理任务的第一轮筛选：

entries, err := os.ReadDir(root)
if err != nil {
    return fmt.Errorf("read directory %q: %w", root, err)
}

for _, entry := range entries {
    if entry.IsDir() {
        fmt.Println("dir:", entry.Name())
    }
}

这里的成功状态很具体：读取失败会在入口返回，成功时只打印目录项名称；普通文件不会进入目录分支。

需要类型位时读取 Type

entry.Type() 返回目录项类型位。它适合做“明显是普通文件、目录或符号链接”的快速判断，但类型位可能不完整，未知位不能被当成普通文件。需要更细的权限、大小或时间时，仍应调用 Info。

参数设计：把快速路径和详情路径拆开

下面的函数只在命中扩展名后读取详情，其他条目停留在轻量判断阶段。这样调用方可以清楚看到哪一步可能因文件系统变化失败：

func listLargeFiles(root string, minSize int64) ([]string, error) {
    entries, err := os.ReadDir(root)
    if err != nil {
        return nil, fmt.Errorf("read %q: %w", root, err)
    }

    var result []string
    for _, entry := range entries {
        if entry.IsDir() || filepath.Ext(entry.Name()) != ".log" {
            continue
        }
        info, err := entry.Info()
        if err != nil {
            return nil, fmt.Errorf("stat %q: %w", entry.Name(), err)
        }
        if info.Size() >= minSize {
            result = append(result, entry.Name())
        }
    }
    return result, nil
}

这段代码的边界是“遇到详情读取错误就失败”。批量清理可以选择记录并跳过，但要把这个策略写在调用层，不能假装 Info 永远成功。

错误处理：条目可能在扫描后立刻消失

目录读取和条目详情读取不是一个不可分割的快照。ReadDir 返回后，另一个进程可能删除文件、修改权限，随后 Info 报错是正常的竞态表现，不是 Go 排序或遍历失效。

如果业务允许“尽力扫描”，可以保留已经收集的结果并记录失败项；如果结果用于备份清单或删除前审计，则应该返回错误，让上层决定是否中止。不要把错误静默转换成零值 FileInfo，否则文件大小为零和读取失败会混在一起。

兼容策略：排序和符号链接要先定规则

ReadDir 的排序语义

os.ReadDir(name) 返回的条目按文件名排序，这对命令行输出和单元测试很友好。若改用目录句柄的 ReadDir(n) 分批读取，则不能依赖每一批都代表完整排序结果；需要稳定全局顺序时，应自行归并或改回一次性读取。

不要混淆链接自身与链接目标

符号链接的目录项自身可以通过类型位观察到。若业务要判断链接目标是否为目录，需要按明确的跟随链接策略读取信息；如果清理任务不应跟随链接，就应在发现链接时直接跳过，并在日志中说明原因。

一个可验证的最小测试

测试不必依赖系统固定目录。用 t.TempDir 创建普通文件和子目录，先验证分类，再为需要大小的条目调用 Info：

func TestListEntries(t *testing.T) {
    root := t.TempDir()
    if err := os.WriteFile(filepath.Join(root, "a.log"), []byte("ok"), 0o600); err != nil {
        t.Fatal(err)
    }
    if err := os.Mkdir(filepath.Join(root, "cache"), 0o755); err != nil {
        t.Fatal(err)
    }

    entries, err := os.ReadDir(root)
    if err != nil {
        t.Fatal(err)
    }
    if got := entries[0].Name(); got != "a.log" {
        t.Fatalf("first entry = %q", got)
    }
    if !entries[1].IsDir() {
        t.Fatalf("second entry should be a directory")
    }
    info, err := entries[0].Info()
    if err != nil || info.Size() != 2 {
        t.Fatalf("file info = %#v, err = %v", info, err)
    }
}

常见问题

os.ReadDir 会递归读取子目录吗？

不会。它只读取指定目录的直接子项；递归需要在确认 IsDir 后显式进入子目录。

知道文件大小还需要调用 Info 吗？

需要。DirEntry 不直接提供大小，Info 返回的 FileInfo 才包含 Size、权限和修改时间等信息。

Info 失败时应该跳过还是终止？

取决于结果用途。展示型扫描通常记录后跳过，备份、审计和删除前清单更适合终止并把错误交给上层。

收束：先分类，再深读

把 DirEntry 当成目录扫描的第一层接口，先解决名称、目录性和类型分流，再为确实需要的条目调用 Info。这样代码的错误边界更清楚，排序行为可验证，符号链接策略也不会隐藏在一次无差别的元数据读取里。