filepath.Walk 是遍历目录最稳妥的选择，因其内置处理符号链接循环、权限拒绝等边界情况且跨平台一致；误用 WalkDir 可能导致无限递归，而 Walk 会自动检测跳过。
用 filepath.Walk 遍历目录是最稳妥的选择
Go 标准库不推荐手写递归函数遍历目录，filepath.Walk 内部已处理符号链接循环、权限拒绝、路径长度等边界情况，且行为跨平台一致。直接调用它比自己写 os.ReadDir + 递归更安全。
常见错误是误用 filepath.WalkDir（Go 1.16+ 引入），它虽支持跳过子目录，但默认不自动处理 symlink 循环 —— 若目标目录含软链指向父级，WalkDir 可能无限递归或 panic，而 filepath.Walk 会自动检测并跳过。
-
filepath.Walk第二个参数是func(path string, info os.FileInfo, err error) error，err 不为 nil 时通常表示权限不足或路径不存在，返回filepath.SkipDir可跳过当前目录继续 - 若需提前终止，返回非 nil error 即可；但注意：该 error 不会作为函数返回值抛出，仅用于中断遍历
- 遍历顺序不保证，不要依赖字母序或创建时间顺序
过滤文件类型时别只看扩展名
仅靠 strings.HasSuffix(info.Name(), ".go") 会漏掉无扩展名的脚本或误判 .go.swp 类临时文件。应优先用 info.Mode().IsRegular() 排除非普通文件（如目录、设备文件、socket），再结合 mime.TypeByExtension 或内容检测（如读前几字节判断 magic number）。
- 扩展名不可信：Linux 下
main可能是 Go 可执行文件，config.json.bak是备份而非 JSON - 避免在
Walk回调里对每个文件都调用os.Open读内容 —— I/O 开销大，可先用info.Size()快速排除超大文件 - 若需区分文本/二进制，用
filetype库或简单检查前 512 字节是否含 null 字节（bytes.Contains(data[:n], []byte{0})）
并发遍历时小心 os.File 关闭和路径竞态
很多人想加速遍历就开 goroutine，但直接在回调里启动 goroutine 并发处理文件，容易踩两个坑：一是 info 是复用对象，不同 goroutine 读到的可能是同一内存地址的旧值；二是 filepath.Walk 本身不是并发安全的，不能多个 goroutine 同时调用它遍历同一根目录。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：用
filepath.Walk收集路径切片，再用sync.Pool或固定 worker 数量的 goroutine 池处理，避免无限制创建 goroutine - 每个 goroutine 中必须用
os.Open(path)打开新句柄，不能复用上级传入的*os.File—— 它可能已被其他 goroutine 关闭 - 路径字符串要显式拷贝：写成
path := path（短变量声明）再传入 goroutine，否则闭包捕获的是循环变量引用
os.ReadDir + 手动递归适合需要精确控制的场景
当必须跳过特定子目录（如 .git、node_modules）、或需按深度优先/广度优先顺序处理、或要统计每层目录数时，filepath.Walk 的黑盒逻辑反而碍事。此时用 os.ReadDir（Go 1.16+，比 ioutil.ReadDir 更高效）手动递归更清晰。
-
os.ReadDir返回[]fs.DirEntry，比os.FileInfo轻量，不触发系统调用获取完整信息，用entry.IsDir()判断即可 - 递归前先检查
entry.Name() == ".git" || entry.Name() == "node_modules"，直接 continue 跳过，避免进入深层目录 - 深度限制建议用参数传递，而非全局变量 —— 多次调用时状态易污染
- 注意 Windows 路径分隔符：用
filepath.Join(root, entry.Name())拼接，别用root + "/" + entry.Name()
真正麻烦的不是怎么写递归，而是如何应对 symlink 循环、NFS 挂载点卡死、权限突然变更这些现实问题 —— filepath.Walk 已覆盖大部分，但自定义逻辑里得自己加 timeout 和 context.WithCancel。
