Go 1.16起推荐用os.ReadDir（非递归、高效）或filepath.WalkDir（递归、安全），替代已弃用的ioutil.ReadDir；前者返回fs.DirEntry轻量接口，后者支持深度优先遍历与错误中断。
在 Go 语言中，ioutil.ReadDir 已被弃用（自 Go 1.16 起），推荐使用 os.ReadDir 或 filepath.WalkDir 来遍历目录。下面介绍几种常用、安全且符合现代 Go 实践的方式。
使用 os.ReadDir 列出当前目录文件（推荐）
os.ReadDir 是轻量、高效、只读的目录遍历方式，返回 []fs.DirEntry，不加载完整文件信息（如内容或详细系统属性），适合快速列出文件名和基础类型判断。
- 它不会递归，仅读取指定目录下的一级条目
- 支持通过
entry.IsDir()区分文件与子目录 - 比
os.ReadDir+os.Stat组合更高效（避免多次系统调用）
示例：
package main
import (
"fmt"
"os"
)
func main() {
entries, err := os.ReadDir(".")
if err != nil {
panic(err)
}
for _, entry := range entries {
if entry.IsDir() {
fmt.Printf("[DIR] %s\n", entry.Name())
} else {
fmt.Printf("[FILE] %s\n", entry.Name())
}
}
}
使用 filepath.WalkDir 递归遍历整个目录树
当需要访问子目录及所有嵌套文件时，filepath.WalkDir 是标准且推荐的方式。它按深度优先顺序遍历，支持中断（返回非 nil error 可停止）。
立即学习“go语言免费学习笔记（深入）”；
-
回调函数接收路径字符串和
fs.DirEntry，无需额外Stat - 自动跳过权限不足的目录（可自定义错误处理）
- 相比旧版
filepath.Walk，性能更好、更安全
示例（只打印普通文件路径）：
package main
import (
"fmt"
"io/fs"
"path/filepath"
)
func main() {
filepath.WalkDir(".", func(path string, d fs.DirEntry, err error) error {
if err != nil {
return nil // 忽略无法访问的路径（如 permission denied）
}
if !d.IsDir() {
fmt.Println("File:", path)
}
return nil
})
}
兼容旧代码：为什么不要用 ioutil.ReadDir
ioutil.ReadDir 在 Go 1.16 中已被移入 io/ioutil 包并标记为废弃，其底层调用 os.ReadDir 后又对每个条目执行 os.Stat，造成冗余系统调用，性能较差，且返回 []os.FileInfo 类型已不如 fs.DirEntry 轻量灵活。
- 如果你看到老项目里用了
ioutil.ReadDir，建议直接替换为os.ReadDir - 若需完整
FileInfo（如修改时间、大小），可对特定条目显式调用d.Info()
小技巧：过滤文件类型或按名称排序
os.ReadDir 返回的条目默认是无序的（取决于文件系统）。如需排序，可手动排序；如需过滤（如只取 .go 文件），用简单条件判断即可：
entries, _ := os.ReadDir(".")
// 过滤并排序
var goFiles []string
for _, e := range entries {
if !e.IsDir() && filepath.Ext(e.Name()) == ".go" {
goFiles = append(goFiles, e.Name())
}
}
sort.Strings(goFiles) // 需 import "sort"
不复杂但容易忽略：记得检查错误、区分目录/文件、优先用 fs.DirEntry 接口而非预加载全部元数据。
