应根据需求层级选择：只需单层目录列表用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: %sn", name) } else { fmt.Printf("FILE: %sn", name) } }
用 filepath.WalkDir 递归遍历整个目录树（推荐）
filepath.WalkDir 是 Go 1.16 引入的替代 filepath.Walk 的函数，性能更好、更安全（避免重复 stat、支持跳过子目录等）。它按深度优先顺序访问每个文件/目录，并通过回调函数处理每个路径。
立即学习“go语言免费学习笔记（深入）”；
- 自动递归进入子目录，适合搜索、打包、清理等场景
- 回调函数签名：
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()后，对子目录路径手动处理 - 错误处理较弱，例如权限拒绝可能导致整个遍历终止
如何选择？看需求层级
判断标准很简单：