Golang如何用os.ReadDir获取文件列表

本文深入解析了 Go 1.16+ 中推荐使用的轻量、安全目录遍历方式 `os.ReadDir`，对比其与已弃用的 `ioutil.ReadDir` 及传统 `filepath.Walk` 的核心差异：它返回无需额外系统调用即可获取文件名和类型判断的 `fs.DirEntry` 切片，显著提升性能与内存效率；同时强调实用要点——需手动过滤 `.` 和 `..`、出错即终止的严格语义、谨慎调用可能失败的 `entry.Info()`，以及在需要容错遍历时应切换至 `filepath.WalkDir`。无论你是编写 CLI 工具还是日常文件操作，掌握 `os.ReadDir` 的正确用法都能让你的 Go 代码更健壮、更高效。

os.ReadDir 是 Go 1.16+ 推荐的目录遍历方式

它比 os.ReadDir 之前的 filepath.Walk 或 os.Open + Readdir 更轻量、更安全：不递归、不自动解析符号链接、返回 fs.DirEntry 而非完整 os.FileInfo，节省系统调用开销。如果你用的是 Go 1.16 及以上（现在绝大多数项目都满足），直接用 os.ReadDir 就行，不用绕路。

用 os.ReadDir 列出当前目录文件名（不含路径）

这是最常见需求——只要名字，不关心类型或大小。注意 os.ReadDir 返回的是 []fs.DirEntry，每个条目有 Name() 和 IsDir() 方法，但默认不加载完整元数据：

entries, err := os.ReadDir(".")
if err != nil {
    log.Fatal(err)
}
for _, entry := range entries {
    fmt.Println(entry.Name())
}

• entry.Name() 返回纯文件/目录名，不含路径
• 不会自动跳过 . 或 ..，需要手动过滤：if entry.Name() == "." || entry.Name() == ".." { continue }
• 如果只想要普通文件（排除目录），加判断：if !entry.IsDir() { ... }

os.ReadDir 和 ioutil.ReadDir（已弃用）的区别

ioutil.ReadDir 在 Go 1.16 被标记为 deprecated，它内部调用 os.Open + Readdir，返回 []os.FileInfo，每次都要触发 stat 系统调用。而 os.ReadDir 的 DirEntry 默认只读取目录项基本信息，entry.Info() 才真正调用 stat —— 这意味着：

• 如果你只需要文件名或是否为目录，os.ReadDir 明显更快、更省内存
• 如果你需要修改时间、大小等字段，必须显式调用 entry.Info()，但会带来额外开销
• 别混用：不能把 os.ReadDir 的结果传给期望 []os.FileInfo 的旧函数

处理权限错误或不存在的目录

os.ReadDir 遇到权限不足（如 permission denied）或路径不存在时，会直接返回 error，不会部分成功。这意味着：

• 它不会像 filepath.Walk 那样提供错误回调；出错就中断
• 如果目标路径可能不可读，务必检查 err，尤其在 CLI 工具中，别假设目录一定存在
• 常见错误信息包括：open /path: permission denied、open /path: no such file or directory
• 若需容错遍历（比如跳过无法访问的子目录），得换用 filepath.WalkDir 并配合 WalkDirFunc 处理 error

真正要注意的是：别在循环里反复调用 entry.Info() 却忽略它可能返回 error —— 比如某些文件系统里，符号链接指向无效路径时，entry.Info() 会失败，但 entry.Name() 和 entry.IsDir() 仍可用。

终于介绍完啦！小伙伴们，这篇关于《Golang如何用os.ReadDir获取文件列表》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！