Go filepath.WalkDir 返回 DirEntry 时怎么读取文件类型

我第一次把 filepath.Walk 改成 filepath.WalkDir 时，最容易混淆的不是遍历本身，而是回调里的第二个参数变成了 fs.DirEntry。它能告诉你名称、是否为目录和一部分类型位，但它不是可以直接调用 Size 的完整文件信息对象。

这篇文章的结论很简单：只想分流目录和条目类型时优先用 d.IsDir()、d.Type()；需要大小、权限或确定“确实是普通文件”时再调用 d.Info()。不要把 d.Type() == 0 直接等同于普通文件，因为类型位未知时也可能得到零。

先分清 DirEntry 三种读取入口

filepath.WalkDir(root, fn) 会把根路径和子项交给 fs.WalkDirFunc。在回调中，d.Name() 只给出基本名称，d.IsDir() 适合快速判断目录，d.Type() 返回 fs.FileMode 的类型位子集，d.Info() 才返回带大小、权限和修改时间的 fs.FileInfo。

用 Type 和 FileMode 判断文件类别

处理大量目录项时，我通常先用 IsDir 做第一层分流，再读取 Type 的特殊位。比如符号链接可以用 mode&fs.ModeSymlink != 0 判断；其他特殊文件也可以检查对应的 ModeNamedPipe、ModeSocket 等类型位。

// 这个回调只做轻量分类，不为每个条目读取完整元数据。
func classify(path string, d fs.DirEntry, err error) error {
    if err != nil {
        return err // 先处理访问或读取目录失败，避免解引用无效 d
    }
    if d.IsDir() {
        return nil // 目录继续遍历；需要跳过时可返回 fs.SkipDir
    }

    mode := d.Type() // 这里只拿类型位，不代表完整权限和大小
    switch {
    case mode&fs.ModeSymlink != 0:
        fmt.Println("symlink:", path)
    case mode&fs.ModeType == 0:
        fmt.Println("regular-or-unknown:", path)
    default:
        fmt.Println("special:", path, mode)
    }
    return nil
}

这里的 regular-or-unknown 是有意保守的命名：普通文件的类型位本来就是零，而某些文件系统也可能无法在目录读取阶段提供完整类型。若业务要求“只处理确定的普通文件”，不要停在 Type。

需要完整元数据时调用 Info

d.Info() 返回的是条目对应的 fs.FileInfo，可以继续读取 Size()、Mode() 和 ModTime()。它可能因为条目在目录读取后被删除或重命名而返回错误，所以不能写成忽略错误的单行转换。

// 需要确认普通文件并读取大小时，使用 Info 的完整模式。
func collectRegular(path string, d fs.DirEntry, err error) error {
    if err != nil {
        return err // 回调错误优先返回，d 可能为空
    }
    if d.IsDir() {
        return nil
    }

    info, err := d.Info()
    if err != nil {
        return fmt.Errorf("读取 %s 的文件信息失败: %w", path, err)
    }
    if !info.Mode().IsRegular() {
        return nil // 符号链接或其他特殊文件不进入普通文件集合
    }
    fmt.Printf("%s %d bytes\n", path, info.Size()) // Size 只在 Info 成功后读取
    return nil
}

符号链接还要单独留意：DirEntry.Info() 描述的是链接本身，而不是链接目标。filepath.WalkDir 默认也不会跟随目录中的符号链接，因此如果业务目标是统计目标文件大小，就应该明确设计一次额外的目标解析，而不是把 Info 当成 Stat 的无条件替代品。

把判断组合进稳定的遍历回调

实际项目里可以把“错误处理—目录分流—类型读取—业务动作”保持在同一个回调边界内。WalkDir 按词法顺序遍历，路径分隔符使用操作系统约定；返回 fs.SkipDir 可以跳过当前目录，返回 fs.SkipAll 可以停止剩余遍历。

// 只收集确定的普通文件，并跳过缓存目录。
func walk(root string) error {
    return filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
        if err != nil {
            if d != nil && d.IsDir() {
                return fs.SkipDir // 目录不可读时放弃该子树
            }
            return err // 根路径或文件本身失败，交给调用方处理
        }
        if d.IsDir() && d.Name() == "cache" {
            return fs.SkipDir // 当前目录不再向下展开
        }
        if d.IsDir() {
            return nil
        }

        info, infoErr := d.Info()
        if infoErr != nil {
            return infoErr // 不把未知信息误报成普通文件
        }
        if info.Mode().IsRegular() {
            fmt.Println(path, info.Size())
        }
        return nil
    })
}

复查时可以记住三个判断：只分目录，用 IsDir；只识别特殊类型，用 Type；要确认普通文件或读取大小，用 Info 并处理错误。这样既保留了 WalkDir 避免对每个条目立即做额外状态查询的优势，也不会因为零类型位而误判。

常见问题

d.Type() == 0 能说明一定是普通文件吗？

不能。普通文件通常没有额外类型位，但类型信息未知时也可能是零。需要确定普通文件时调用 d.Info()，再检查 info.Mode().IsRegular()。

WalkDir 会跟随符号链接吗？

不会跟随目录中的符号链接；DirEntry.Info() 描述链接本身。若要处理链接目标，应把目标解析作为单独且明确的业务步骤。