filepath.walkdir 更值得优先使用，因其默认用 io/fs.direntry 避免冗余 stat 调用，性能提升 2–5 倍，并支持 skipdir、错误分离及按需调用 info()。
filepath.WalkDir 为什么比 filepath.Walk 更值得优先用
因为 filepath.WalkDir 默认使用 io/fs.DirEntry，不强制读取文件详情（比如 os.FileInfo），避免了大量不必要的 stat 系统调用。尤其在遍历含成千上万个文件的目录时，性能提升明显——实测快 2–5 倍，取决于文件系统和路径深度。
它还天然支持跳过子目录（返回 filepath.SkipDir）、提前终止（返回非 nil error）、以及更清晰的错误分离（fs.ReadDirFS 类型错误不会混进业务逻辑）。
- 仅当需要所有文件的
ModTime()、Size()或权限位时，才考虑降级用filepath.Walk -
WalkDir的回调函数签名是func(path string, d fs.DirEntry, err error) error，注意d是DirEntry，不是FileInfo - 若需
FileInfo，显式调用d.Info()—— 这步会触发一次stat，按需调用，别无脑写
如何安全过滤隐藏文件和 .git 目录
常见错误是只检查 path 字符串是否以 . 开头，但这样会漏掉 Windows 下的 desktop.ini 或 macOS 的 .DS_Store，且无法跳过整个 .git 目录树。
正确做法是在回调中判断 d 是否为目录，并结合 d.Name() 做匹配，再返回 filepath.SkipDir：
err := filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
if err != nil {
return err
}
name := d.Name()
if name == ".git" || name == ".svn" || strings.HasPrefix(name, ".") {
if d.IsDir() {
return filepath.SkipDir
}
}
// 其他处理逻辑...
return nil
})
-
d.IsDir()比strings.HasSuffix(path, "/.git")更可靠，避免误判文件名为.gitignore的情况 - 不要在
name == ".git"后直接return nil—— 那样仍会继续遍历其内部，必须用filepath.SkipDir - Windows 下注意大小写：
.GIT也应纳入过滤，可统一转小写比较
遇到 permission denied 错误该怎么处理
filepath.WalkDir 在进入无权限目录（如 /root、某些 /proc 子目录）时会传入非 nil err，此时 d 可能为 nil，不能调用 d.Name() 或 d.IsDir()，否则 panic。
必须先判空再操作：
err := filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
if err != nil {
if errors.Is(err, fs.ErrPermission) {
log.Printf("skip %s: permission denied", path)
if d != nil && d.IsDir() {
return filepath.SkipDir
}
return nil // 跳过文件，继续遍历
}
return err // 其他错误（如 I/O）不忽略
}
// 正常处理 d 和 path...
return nil
})
-
errors.Is(err, fs.ErrPermission)比字符串匹配更健壮 - 即使
d == nil，path仍是有效的（表示出错的路径），可用于日志或统计 - 返回
filepath.SkipDir仅对目录有效；对无权限文件，返回nil即可跳过，无需 panic
WalkDir 遍历时怎么控制并发或限速
filepath.WalkDir 本身是同步阻塞的，不支持内置并发。若想限速（比如防止磁盘 IO 打满）或并行扫描多个根目录，得自己封装。
典型做法：启动 goroutine 处理每个子目录，用 semaphore 控制并发数，主协程收集结果：
sem := make(chan struct{}, 4) // 最多 4 个并发
var wg sync.WaitGroup
for _, root := range roots {
wg.Add(1)
go func(r string) {
sem
- 别对单个
WalkDir内部做 goroutine 分割 —— 它的遍历顺序依赖文件系统 readdir 行为，乱序并发反而易出错 - 如果目标是“慢速遍历”，用
time.Sleep在 handler 里加延迟即可，但注意别在err != nil分支里 sleep，否则卡住错误恢复 - 需要结果排序？别依赖
WalkDir输出顺序 —— 不同 OS / 文件系统 readdir 结果不同，务必在收集完后显式sort.Strings
实际项目里最常被忽略的是 d 为 nil 时的空指针防护，以及误把 filepath.SkipDir 当作普通返回值忽略——它只在目录场景下生效，且必须由回调函数显式返回。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
