Go 1.16+ 中应使用 os.ReadDir 替代已弃用的 io/ioutil.ReadDir；os.ReadDir 返回轻量级 fs.DirEntry，支持 Name()、IsDir() 等方法，需 Info() 获取完整文件信息；嵌套目录遍历推荐 filepath.WalkDir。
在 Go 1.16+ 中，io/ioutil 已被弃用（deprecated），其功能已迁移至 os 和 io/fs 包。因此，**不推荐再使用 io/ioutil.ReadDir 或 io/ioutil.ReadDir 的旧方式获取目录文件列表和文件信息**。下面介绍现代、标准、安全的替代方法。
使用 os.ReadDir 获取目录文件名与基础信息
os.ReadDir 返回 []fs.DirEntry，轻量高效，不加载完整文件信息（如大小、修改时间需显式调用 Info()）：
- 适合只需文件名、是否为目录等快速判断的场景
- 比
os.ReadDir（注意：不是io/ioutil.ReadDir）更省内存 - 返回的
DirEntry支持Name()、IsDir()、Type()等方法
示例：
entries, err := os.ReadDir("./mydir")
if err != nil {
log.Fatal(err)
}
for _, entry := range entries {
fmt.Printf("Name: %s, IsDir: %t\n", entry.Name(), entry.IsDir())
}
使用 os.ReadDir + Info() 获取完整文件信息
若需文件大小、修改时间、权限等详细信息，对每个 DirEntry 调用 Info()：
立即学习“go语言免费学习笔记（深入）”；
-
entry.Info()返回os.FileInfo，包含Size()、ModTime()、Mode()等 - 注意：每次调用
Info()会触发一次系统调用，批量处理时有一定开销 - 适用于需要元数据但目录项不多（如配置目录、日志目录）的场景
示例：
entries, err := os.ReadDir("./mydir")
if err != nil {
log.Fatal(err)
}
for _, entry := range entries {
info, err := entry.Info()
if err != nil {
log.Printf("skip %s: %v", entry.Name(), err)
continue
}
fmt.Printf("%s | size: %d | mod: %s | mode: %s\n",
info.Name(), info.Size(), info.ModTime().Format("2006-01-02"), info.Mode())
}
使用 filepath.WalkDir 遍历嵌套目录（含子目录）
当需要递归读取整个目录树（包括子目录）时，filepath.WalkDir 是首选：
- 支持深度优先遍历，自动处理符号链接（可配置跳过）
-
回调函数接收
fs.DirEntry，同样可调用Info()获取详情 - 可通过返回非 nil error 控制遍历行为（如跳过某子目录）
示例（仅打印所有普通文件路径）：
err := filepath.WalkDir("./mydir", func(path string, d fs.DirEntry, err error) error {
if err != nil {
return err
}
if !d.IsDir() {
fmt.Println("File:", path)
}
return nil
})
if err != nil {
log.Fatal(err)
}
避免踩坑：关于 io/ioutil.ReadDir 的兼容说明
虽然 io/ioutil.ReadDir 在 Go 1.15 及更早版本中可用，但它：
- 返回
[]os.FileInfo，内部强制调用Info()，性能不如os.ReadDir - Go 1.16+ 编译会报 warning，未来版本将移除
- 无法区分符号链接与真实目录（
IsDir()对 symlink 可能返回 false） - 不支持自定义遍历控制（如跳过某些路径）
如需临时兼容老代码，建议直接替换为 os.ReadDir + 显式 Info() 调用，逻辑更清晰、可控性更强。
