优先用filepath.WalkDir(Go 1.16+)，因其不强制stat、支持精准跳过子目录、能显式处理符号链接和权限错误；filepath.Walk易静默终止、不支持可控跳过且性能较差。
用 filepath.Walk 遍历目录，但别直接改路径字符串
Go 标准库推荐用 filepath.Walk 做递归遍历，它自动处理符号链接、权限错误和跨平台路径分隔符。常见误区是拿到 path 后手动拼接子路径（比如 path + "/sub"），这在 Windows 上会出错——filepath.Walk 返回的路径已经是完整、规范的，直接用即可。
正确做法是：在回调函数里对当前 path 做判断或操作，需要构造子路径时一定用 filepath.Join(path, "sub")。
- 传入的
root参数必须是绝对路径或相对于当前工作目录的有效路径，相对路径容易因os.Chdir变更导致行为不一致 - 回调函数返回非
nil错误（如filepath.SkipDir）可跳过该目录，但返回errors.New("xxx")会中断整个遍历 - 如果需并发处理文件，不要在回调里直接启 goroutine 并共享
path变量——循环中path会被复用，应拷贝到局部变量
filepath.WalkDir 比 Walk 更轻量，且能控制遍历深度
filepath.WalkDir 是 Go 1.16+ 引入的替代方案，底层用 io/fs.ReadDir，不触发 stat 调用，性能更好，也天然支持跳过子树（返回 fs.SkipDir）。它还允许你在进入目录前就拿到目录项信息，适合做预过滤。
例如想只遍历两层深：
立即学习“go语言免费学习笔记（深入）”；
err := filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
if err != nil {
return err
}
depth := strings.Count(path, string(filepath.Separator))
if depth >= 2 && d.IsDir() {
return fs.SkipDir
}
// ... 处理文件
return nil
})
-
fs.DirEntry的IsDir()不触发额外系统调用，比os.Stat().IsDir()快 - 注意
filepath.WalkDir不自动解析符号链接，若需跟随链接，得自己用os.ReadDir+ 递归实现 - Windows 下长路径（>260 字符）可能被截断，需确保程序 manifest 启用 long path 支持，否则
WalkDir会返回ERROR_INVALID_NAME
遇到 permission denied 别 panic，要区分场景处理
遍历时常遇到 open xxx: permission denied，这不一定是 bug——可能是用户没权限读某个目录（如 /proc 下的进程子目录），也可能是文件被其他进程独占锁住（Windows 常见）。直接 panic 会让整个工具崩掉，不合理。
- 在回调里检查
err是否为os.ErrPermission或os.IsPermission(err)，然后选择跳过并记录警告，而非终止 - 若目标是“尽最大努力扫描”，可忽略所有
os.IsPermission和os.IsNotExist错误；但如果是配置校验类场景（如检查部署目录结构），则应把权限错误当作硬性失败 - Linux 下某些挂载点（如 cgroup v2）可能返回
syscall.EACCES，需用errors.Is(err, syscall.EACCES)显式判断
避免用 runtime.GOMAXPROCS 强行加速遍历
有人以为开更多 goroutine 就能更快遍历磁盘，于是给每个子目录启一个 goroutine，再用 sync.WaitGroup 等待——实际效果往往更差。磁盘 I/O 是瓶颈，不是 CPU，大量并发读会导致磁头/SSD 随机寻道加剧，吞吐反而下降。
真正有效的优化方式只有两个：
- 用
filepath.WalkDir替代Walk（减少 stat 调用） - 批量处理文件内容（比如用
bufio.Scanner读多个小文件，而不是为每个文件建新os.File）
如果你真需要并发处理文件内容（如计算 hash），应在遍历完成后，把文件路径切片分批丢进 worker pool，而不是在遍历过程中动态派生 goroutine。
