必须用 filepath.walkdir 而不是 filepath.walk，因其避免冗余 os.lstat、支持权限错误跳过（filepath.skipdir）、实测快20%–40%，且提供 fs.direntry 零开销操作；而 filepath.walk 易因 /proc 权限错误中断、无 symlink 循环防护、不支持深度控制。
Go 1.16+ 下，filepath.WalkDir 是处理多层级路径递归搜索的默认选择，它比 filepath.Walk 更快、更可控，且能主动跳过权限错误和指定目录；盲目用 os.ReadDir 手写递归反而容易漏掉 symlink 循环防护或深度失控。
为什么必须用 filepath.WalkDir 而不是 filepath.Walk
filepath.Walk 对每个条目都隐式调用 os.Lstat，哪怕你只关心文件名——这在嵌套深、文件多的路径下会触发大量冗余系统调用；而 filepath.WalkDir 返回的 fs.DirEntry 已含类型和名称，d.Name() 和 d.IsDir() 都是零开销操作。
- 常见错误现象：
filepath.Walk在遇到/proc或/sys下的权限拒绝时直接返回 error 并终止，整个扫描就断了；filepath.WalkDir允许你在回调里判os.IsPermission(err)后返回filepath.SkipDir，继续往下扫 - 性能影响：实测大目录（如
$GOPATH/src）下，filepath.WalkDir比filepath.Walk快 20%–40%，主要省在避免重复stat - 兼容性注意：Go 1.15 及更早版本不支持
filepath.WalkDir，降级方案只能是缓存os.FileInfo+ 手动控制遍历逻辑，但维护成本高
匹配逻辑别塞进 Walk 回调，抽成 Matcher 函数
硬编码判断（比如 strings.HasSuffix(d.Name(), ".go")）会让后续加规则（如排除 node_modules、忽略隐藏文件、按大小筛选）变得脆弱且难测试。
- 定义类型
type Matcher func(path string, d fs.DirEntry) bool，把后缀、路径前缀、正则等拆成独立函数 - 组合多个条件时用
&&或||，例如：isGoFile && notInNodeModules && !isHidden - 正则匹配务必预编译：
var goPattern = regexp.MustCompile(<code>^main\.go$)，别在每次回调里regexp.Compile - 路径判断优先用
strings.HasSuffix(d.Name(), ".log")，而非filepath.Ext(path) == ".log"——后者对app.log.bak也会误判
symlink 和深度控制必须显式做，Go 不自动兜底
filepath.WalkDir 默认不检测 symlink 循环，也不限制递归深度。真实环境里，/proc/self/fd、用户手动创建的 A→B→A 链接，都会导致无限递归甚至栈溢出。
- 判断 symlink：用
d.Type() & os.ModeSymlink != 0，再调os.Readlink获取目标路径 - 防循环：维护一个
map[string]bool记录已访问的绝对路径（建议用filepath.EvalSymlinks展开后存） - 限深度：在回调参数外传入当前深度计数器，每进一层 +1，超阈值（如 32）就 return
filepath.SkipDir - 注意：Windows 下 symlink 支持需管理员权限开启，且
os.Readlink可能返回空字符串，要判空处理
中断扫描别 panic，用 context 控制流更稳
filepath.WalkDir 本身不接受 context.Context，但用户按 Ctrl+C 时不能让程序 panic 或卡死——得靠外部协程配合信号监听实现优雅退出。
- 启动
WalkDir前创建ctx, cancel := context.WithCancel(context.Background()) - 另起 goroutine 监听
os.Interrupt，收到信号后调cancel() - 回调函数开头加
select { case ，每处理几百个文件检查一次，避免响应延迟 - 切忌在回调里做耗时 I/O（如打开并读取每个文件内容），否则中断响应会卡住好几秒
最易被忽略的点：fs.DirEntry 的生命周期只在回调内有效，不能保存引用；想复用元数据（如 ModTime）就得立刻调 d.Info()，但别滥用——它会触发一次 stat，抵消性能优势。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
