filepath.Walk是最直接的递归遍历方式，自动处理符号链接、权限错误等边界情况；需用info.IsDir()判断类型并检查err参数，避免静默跳过；filepath.WalkDir性能更优但需手动递归和并发控制。
用 filepath.Walk 是最直接的方式
Go 标准库的 filepath.Walk 就是专为递归遍历设计的，它自动处理符号链接、权限错误、目录循环等边界情况，不用自己写递归逻辑。传入根路径和一个回调函数，每遇到一个文件或目录就会调用该函数一次。
常见错误是误以为它只遍历文件——其实它也遍历目录，需在回调里用 info.IsDir() 判断类型；另一个坑是没检查 err 参数，导致某些子路径出错（如无权限）时静默跳过，后续逻辑可能漏数据。
- 回调函数签名必须是
func(path string, info os.FileInfo, err error) error - 若想跳过某个子目录，返回
filepath.SkipDir；其他非 nil 错误会终止整个遍历 -
info在目录场景下可能为nil（比如权限不足），此时不能直接调info.IsDir()，要先判空
err := filepath.Walk("/tmp", func(path string, info os.FileInfo, err error) error {
if err != nil {
log.Printf("skip %s: %v", path, err)
return nil // 继续遍历其余路径
}
if !info.IsDir() {
fmt.Println("file:", path)
}
return nil
})
需要并发遍历时改用 filepath.WalkDir
filepath.WalkDir（Go 1.16+）比 filepath.Walk 更轻量，它用 fs.DirEntry 替代 os.FileInfo，避免了对每个条目都调 Stat，性能更好，也更适合手动控制并发。
但它不自动递归：你得自己在回调里对子目录调 ReadDir 并启动 goroutine。容易踩的坑是 goroutine 泄漏——没做并发数限制，遇到超深或超宽目录时瞬间起成百上千个 goroutine，OOM 或被系统 kill。
- 用带缓冲的 channel 控制并发数，例如
sem := make(chan struct{}, 10) - 每次进子目录前
sem ，goroutine 结束后 <code><-sem -
DirEntry.Type()可快速判断是否为目录，比Stat开销小得多
遇到符号链接时要注意循环引用
filepath.Walk 默认会跟随符号链接，如果目标指向父目录或自身，就会无限递归直到栈溢出或报 too many levels of symbolic links 错误。
解决方法不是禁用链接（那会丢数据），而是在回调中记录已访问的 inode+device（Linux/macOS）或用绝对路径去重（Windows 需额外处理）。标准库不提供内置去重，得自己维护一个 map[uintptr]struct{} 或 map[string]struct{}。
- 用
info.Sys().(*syscall.Stat_t).Ino和.Dev获取 inode 和设备号（Unix 系统） - Windows 下建议用
filepath.Abs(path)+ 路径字符串去重，但要注意重解析点（reparse points）行为更复杂 - 注意：
filepath.WalkDir的DirEntry不含 inode 信息，此时必须调os.Stat补全，会损失部分性能
过滤特定文件类型时别只靠扩展名
仅用 strings.HasSuffix(path, ".go") 过滤源码文件，会漏掉 main（无后缀）、Dockerfile（无点）、或误杀 notes.md.bak。真实项目中更可靠的是结合 MIME 类型或内容检测。
但大多数 CLI 工具仍用扩展名，因为快且够用。关键是要统一规则：比如 Go 生态习惯把 go.mod、go.sum、Gopkg.lock 都纳入“Go 相关文件”，哪怕它们没 .go 后缀。
- 推荐用
filepath.Base(path)单独匹配文件名，再用filepath.Ext(path)匹配后缀 - 避免写
strings.Contains(path, ".go")—— 它会在路径中间匹配，造成误判 - 如果真要按内容识别（如找 JSON 文件），用
io.LimitReader(f, 512)读头部 +json.Valid()检查，但会显著拖慢遍历速度
实际项目里最常被忽略的是错误传播策略和资源清理：比如遍历中打开的文件没 close，或者大量 filepath.Walk 调用没设 context 控制超时，一卡就是几分钟。这些不体现在核心逻辑里，却决定脚本能不能进 CI 或跑在容器里。
