go 1.16+ 必须用 filepath.walkdir 而非 filepath.walk，因其底层复用 os.readdir 返回 fs.direntry，避免对每个路径重复调用 os.stat，性能提升 2–5 倍；支持原生 filepath.skipdir、明确错误分离、零开销 isdir()/name()，且默认不解析符号链接更安全。
Go 1.16+ 下递归扫描目录，filepath.WalkDir 是唯一推荐的高效起点；用 filepath.Walk 或手动拼接路径、滥用 os.Stat 都会带来隐性性能损失和逻辑陷阱。
为什么必须用 filepath.WalkDir 而不是 filepath.Walk
filepath.Walk 对每个路径都调用 os.Stat，哪怕你只关心文件名——这在含数万小文件的目录下会触发同等次数的系统调用，实测慢 2–5 倍。filepath.WalkDir 底层用 os.ReadDir，返回 fs.DirEntry，d.IsDir() 和 d.Name() 零开销，无需额外 stat。
- 旧代码若还依赖
filepath.Walk，且需兼容 Go 1.15–，应缓存os.FileInfo并复用，避免重复Stat -
filepath.Walk对权限错误（如/proc/self/fd）默认继续，但回调里若忽略err != nil就直接用info，会 panic；WalkDir的err参数更明确，可区分处理 -
filepath.SkipDir在WalkDir中是原生支持的控制信号；Walk只能靠提前return模拟，易误中断整个遍历
filepath.WalkDir 回调里怎么安全跳过子目录
想跳过 node_modules 或 .git？不能靠字符串匹配完整路径，而应在回调中用 d.Name() 判断，并立即返回 filepath.SkipDir。
- 错误写法：
if strings.Contains(path, "node_modules") { return filepath.SkipDir }—— 会漏掉./node_modules这种根级目录，且可能误判my_node_modules_backup - 正确写法：
if d.IsDir() && d.Name() == "node_modules" { return filepath.SkipDir } - 注意：返回
filepath.SkipDir仅跳过当前目录及其全部子树；返回其他非-nil error（如errors.New("stop")）会立刻终止整个遍历 - Windows 下长路径（>260 字符）可能被截断，需确保程序 manifest 启用 long path 支持，否则
WalkDir会返回ERROR_INVALID_NAME
路径拼接和符号链接怎么不出错
拿到 path 参数后别手动拼 path + "/sub"，也别假设符号链接一定可跟随——这两点在 Windows 和循环软链场景下最常翻车。
- 子路径必须用
filepath.Join(path, "sub")：它自动适配\或/，硬拼在 Windows 上直接失效 -
WalkDir默认不解析符号链接；若需跟随，先判断d.Type() & os.ModeSymlink != 0，再用os.Readlink获取目标，然后filepath.Join(filepath.Dir(path), target)构造新路径 - 跟随软链前务必记录已访问路径（如用
map[string]bool），否则A → B、B → A会无限递归 - 传入的
root参数建议先filepath.Clean，避免../导致路径污染或越权访问
并发处理文件时最容易忽略的变量复用问题
在 WalkDir 回调里直接起 goroutine 处理 path，几乎必然出错——因为 path 是循环变量，会被下一轮迭代覆盖。
- 错误写法：
go process(path)—— 所有 goroutine 最终可能都处理同一个path值 - 正确写法：
go func(p string) { process(p) }(path)或localPath := path; go process(localPath) - 纯路径收集不需要并发；只有后续操作是 CPU 密集型（如解析 JSON、计算哈希）才值得拆成生产者-消费者模型
- 并发数别盲目设高，
runtime.GOMAXPROCS和 OS 文件句柄限制（尤其 Windows）会成为瓶颈
真正难的不是写完遍历逻辑，而是当 WalkDir 在 /proc 或网络挂载点上遇到 permission denied 或 device unavailable 时，能否让程序继续而不是崩掉——这要求你把每一种 err 类型都当作正常分支来处理，而不是只盯着 nil。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
