应根据需求层级选择：只需单层目录列表用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、支持跳过子目录等）。它按深度优先顺序访问每个文件/目录，并通过回调函数处理每个路径。
立即学习“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()后，对子目录路径手动处理 - 错误处理较弱，例如权限拒绝可能导致整个遍历终止
如何选择？看需求层级
判断标准很简单：
- 只要当前目录下的文件名列表 → 用
os.ReadDir - 要搜所有子目录里的配置文件、日志、源码 → 用
filepath.WalkDir - 维护老项目且不能升级 Go 版本 → 可用
filepath.Walk，但建议逐步迁移 - 需要并发处理或高级过滤（如按大小、时间范围）→ 可基于
WalkDir封装，或使用第三方库如golang.org/x/tools/filetype
