os.ReadDir 是 Go 1.16+ 推荐的轻量级目录读取方式，返回 []fs.DirEntry，支持按需调用 Info()，应替代已移除的 ioutil.ReadDir；需用 IsDir() 和 Name() 高效判别类型与获取名称，拼接路径须用 filepath.Join。
os.ReadDir 是 Go 1.16+ 推荐的目录读取方式
Go 1.16 起 os.ReadDir 取代了已弃用的 ioutil.ReadDir（后者在 Go 1.16 中已被移除）。它返回 []fs.DirEntry，比 os.FileInfo 更轻量，且支持按需调用 Info()，避免不必要的系统调用开销。
常见错误：仍尝试导入 "io/ioutil" 并调用 ioutil.ReadDir，会直接报错 undefined: ioutil.ReadDir。
- 用
os.ReadDir替代ioutil.ReadDir，无需额外依赖 - 若需完整
os.FileInfo（如文件大小、修改时间），对每个fs.DirEntry显式调用.Info() - 注意：
os.ReadDir不保证顺序，如需字典序请手动sort.Slice
如何安全遍历目录并区分文件与子目录
fs.DirEntry 提供 IsDir() 和 Name() 方法，是判断类型和获取名称的首选——比先调用 .Info() 再查 IsDir() 更高效，因为不触发额外的 stat 系统调用。
典型误用：对每个条目都无条件调用 entry.Info()，导致性能下降，尤其在大目录中明显。
立即学习“go语言免费学习笔记（深入）”；
- 用
entry.IsDir()快速判断是否为目录 - 用
entry.Name()获取文件/目录名（不含路径） - 拼接完整路径时，用
filepath.Join(dirPath, entry.Name())，别直接字符串拼接（Windows 下会出错）
os.ReadDir 与 filepath.Walk 的适用场景差异
os.ReadDir 只读一层，适合「列出当前目录内容」；filepath.Walk 是递归遍历，适合「搜索整个目录树」。两者不可互换，选错会导致逻辑漏洞或无限循环。
容易踩的坑：用 os.ReadDir 实现递归但忘记处理符号链接，或在 Walk 中重复打开同一目录引发 panic。
- 只需列出
/tmp下的文件？→ 用os.ReadDir("/tmp") - 要在
/var/log及其所有子目录中找.log文件？→ 用filepath.Walk("/var/log", ...) - 用
filepath.Walk时，回调函数中若返回filepath.SkipDir可跳过子目录遍历
完整示例：安全读取目录并打印文件/目录标识
package main
import (
"fmt"
"os"
"path/filepath"
)
func main() {
entries, err := os.ReadDir(".")
if err != nil {
fmt.Printf("read dir error: %v\n", err)
return
}
for _, entry := range entries {
name := entry.Name()
if entry.IsDir() {
fmt.Printf("[DIR] %s\n", name)
} else {
// 只有需要详细信息时才调用 Info()
info, _ := entry.Info()
fmt.Printf("[FILE] %s (%d bytes)\n", name, info.Size())
}
}
}
这个例子没用 filepath.Walk，也没做排序，就是最简可用的 os.ReadDir 实践。实际项目中如果要过滤隐藏文件（如 .git）、跳过特定后缀或并发处理，得在此基础上加判断和控制逻辑——那些不是 ReadDir 本身的责任，而是业务层的事。
