应根据需求层级选择：只需单层目录列表用os.ReadDir，需递归遍历整个目录树用filepath.WalkDir；旧版Go兼容可选filepath.Walk，但推荐升级迁移。

在 Go 语言中遍历目录有多种方式，ioutil.ReadDir（已弃用，现为 os.ReadDir）适合简单、单层目录读取；而 filepath.Walk（或更现代的 filepath.WalkDir）适用于递归遍历整个目录树。两者用途不同，选错会导致逻辑错误或性能问题。

用 os.ReadDir 遍历单层目录（推荐替代 ioutil.ReadDir）

ioutil.ReadDir 自 Go 1.16 起已被标记为废弃，应改用 os.ReadDir。它返回 []fs.DirEntry，轻量且不预加载文件信息，适合快速列出当前目录下的条目。

• 只读取指定目录一层，不进入子目录
• 返回的是 fs.DirEntry，调用 .Name() 获取文件名，.IsDir() 判断是否为目录
• 如需详细信息（如大小、修改时间），需额外调用 .Info()（会触发一次系统调用）

示例：

entries, err := os.ReadDir("./data")
if err != nil {
    log.Fatal(err)
}
for _, entry := range entries {
    name := entry.Name()
    if entry.IsDir() {
        fmt.Printf("DIR: %s\n", name)
    } else {
        fmt.Printf("FILE: %s\n", name)
    }
}

用 filepath.WalkDir 递归遍历整个目录树（推荐）

filepath.WalkDir 是 Go 1.16 引入的替代 filepath.Walk 的函数，性能更好、更安全（避免重复 stat、支持跳过子目录等）。它按深度优先顺序访问每个文件/目录，并通过回调函数处理每个路径。

• 自动递归进入子目录，适合搜索、打包、清理等场景
• 回调函数签名：func(path string, d fs.DirEntry, err error) error
• 若在回调中返回 filepath.SkipDir，将跳过当前目录及其所有子项
• 遇到权限错误等可选择忽略或中断

示例：打印所有 .go 文件路径

err := filepath.WalkDir("./src", func(path string, d fs.DirEntry, err error) error {
    if err != nil {
        return err // 或 log.Printf("skip %s: %v", path, err)
    }
    if !d.IsDir() && strings.HasSuffix(d.Name(), ".go") {
        fmt.Println(path)
    }
    return nil
})
if err != nil {
    log.Fatal(err)
}

filepath.Walk 的注意事项（兼容旧版本时使用）

filepath.Walk 仍可用，但内部会对每个路径调用 os.Stat，开销略大；且无法跳过子目录（除非手动拼接路径并提前 return）。若项目需支持 Go

• 回调函数参数是 path string 和 info os.FileInfo，无需再调用 Stat
• 不能直接跳过子目录 —— 必须判断 info.IsDir() 后，对子目录路径手动处理
• 错误处理较弱，例如权限拒绝可能导致整个遍历终止

如何选择？看需求层级

判断标准很简单：

• 只要当前目录下的文件名列表 → 用 os.ReadDir
• 要搜所有子目录里的配置文件、日志、源码 → 用 filepath.WalkDir
• 维护老项目且不能升级 Go 版本 → 可用 filepath.Walk，但建议逐步迁移
• 需要并发处理或高级过滤（如按大小、时间范围）→ 可基于 WalkDir 封装，或使用第三方库如 golang.org/x/tools/filetype