filepath.Walk不跟随符号链接且不检测循环引用，易致栈溢出；推荐改用Go 1.16+的filepath.WalkDir，它支持跳过目录、按需Stat、安全处理symlink和错误，但需注意entry可能为nil及Windows大小写问题。
filepath.Walk 会跳过符号链接，且不自动处理循环引用
默认情况下 filepath.Walk 不会跟随符号链接（symlink），遇到 symlink 时直接调用回调函数，不会进入其指向的目标目录。这点和 shell 的 find 默认行为不同，容易误以为“没遍历到”。更危险的是：如果目录结构中存在循环软链（比如 A → B，B → A），filepath.Walk 会无限递归，最终触发栈溢出或 panic —— 它**不检测路径循环**。
解决办法只有手动记录已访问的 inode + dev（需用 os.Stat 获取）或绝对路径哈希，但成本高；更现实的做法是避免构造含循环链接的目录，或改用 filepath.WalkDir（Go 1.16+）配合自定义逻辑。
filepath.WalkDir 比 Walk 更可控，推荐替代使用
filepath.WalkDir 是 Go 1.16 引入的替代方案，它返回 fs.DirEntry 而非 os.FileInfo，省去大量 Stat 调用，性能更好；更重要的是，它允许你在回调中返回 filepath.SkipDir 跳过子目录，或返回非 nil error 终止遍历。
- 用
entry.Type().IsDir()判断是否为目录，再决定是否Stat—— 避免对每个文件都做系统调用 - 若需跳过特定目录（如
node_modules），在回调里检查entry.Name()后直接 returnfilepath.SkipDir - 对 symlink，
entry.Type()返回fs.ModeSymlink，你可以选择是否os.Readlink后继续 walk
示例片段：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
err := filepath.WalkDir("./src", func(path string, entry fs.DirEntry, err error) error {
if err != nil {
return err
}
if entry.Name() == "vendor" && entry.IsDir() {
return filepath.SkipDir
}
if entry.Type().IsRegular() && strings.HasSuffix(entry.Name(), ".go") {
fmt.Println(path)
}
return nil
})
错误处理不能只看 err 参数，还要检查 entry 是否为 nil
filepath.WalkDir 的回调函数签名是 func(path string, entry fs.DirEntry, err error) error，但很多人忽略一个关键点：当 err != nil 时，entry 可能为 nil —— 比如路径权限不足、设备脱机、或父目录不可读。此时若直接调用 entry.Name() 会 panic。
- 必须先判断
err != nil，再决定是否处理entry - 常见错误场景：
permission denied（err.Error()包含该字符串）、no such file or directory - 若想静默跳过权限错误，可检查
os.IsPermission(err)后 return nil；但不要无条件 ignore 所有 err
Windows 下路径分隔符和大小写敏感性要特别注意
filepath.Walk 和 filepath.WalkDir 在 Windows 上使用 作为分隔符，但 Go 的 filepath 包内部会统一转义，所以你传入 "C:/foo" 或 "C:\foo" 都可以。真正容易出错的是大小写比较：
- Windows 文件系统默认不区分大小写，但
strings.EqualFold不等于“路径等价”——比如C:Foo和c: oo是同一路径，但字符串比较不相等 - 若需过滤特定扩展名（如
.GO），别用strings.HasSuffix(name, ".go")，改用strings.HasSuffix(strings.ToLower(name), ".go") - 避免用
==比较完整路径字符串，尤其跨平台开发时；如需路径相等判断，用filepath.EvalSymlinks+filepath.Clean标准化后再比
路径处理的复杂性往往不在遍历逻辑本身，而在边界条件：符号链接、权限、大小写、循环、跨平台分隔符。写完记得在真实目录结构（含空目录、只读文件、broken symlink）里跑一遍，而不是只测干净的测试用例。
