filepath.Walk比手写递归更安全，因其内置symlink循环检测、权限错误跳过、深度可控及栈安全机制；手写递归需手动加深度限制、inode缓存和错误处理防护。
递归遍历目录时为什么 filepath.Walk 比手写递归更安全
因为手写递归容易忽略符号链接循环、权限拒绝、路径深度爆炸等问题，而 filepath.Walk 内置了错误处理跳过机制和 symlink 循环检测（通过维护已访问 inode 缓存），且默认不递进进入不可读目录，避免 panic。
-
filepath.Walk是广度优先 + 递归混合实现，内部用栈而非函数调用栈，规避 goroutine 栈溢出风险 - 手动递归若未限制深度，遇到恶意构造的嵌套软链（如
a → b → a）会无限调用，最终 stack overflow -
filepath.Walk在遇到os.ErrPermission时只跳过当前路径，继续遍历兄弟节点；手写递归常因未 recover 错误直接中断整个遍历
如何用 filepath.Walk 替代手写递归并保留控制权
它不是黑盒：你可以通过返回非 nil error 控制遍历行为，比如跳过特定子目录或提前终止。
- 返回
filepath.SkipDir可跳过当前目录及其所有子项（等价于递归中不进入该 dir） - 返回其他 error（如
errors.New("stop now")）会中止整个遍历，filepath.Walk直接返回该 error - 注意：不能在回调函数里 recover panic，必须靠返回 error 控制流程
err := filepath.Walk("/path", func(path string, info fs.FileInfo, err error) error {
if err != nil {
if errors.Is(err, os.ErrPermission) {
return nil // 忽略权限错误，继续
}
return err
}
if info.IsDir() && info.Name() == "node_modules" {
return filepath.SkipDir // 跳过该目录
}
fmt.Println(path)
return nil
})
需要真正递归逻辑时，怎么加安全防护
比如你要统计每层目录深度、或按深度做不同处理，这时才需手写递归——但必须加三层防护。
- 用
depth参数限制最大递归深度（建议 ≤ 100），超过即 return - 用
map[uint64]bool记录已访问的info.Sys().(*syscall.Stat_t).Ino，防止 symlink 循环（Linux/macOS） - 对每个
os.ReadDir结果做err != nil判断，遇到os.ErrPermission不 panic，仅 log 并 continue
示例关键片段：
func walkSafe(path string, depth int, visited map[uint64]bool) error {
if depth > 100 {
return fmt.Errorf("max depth exceeded: %s", path)
}
f, err := os.Open(path)
if err != nil {
if errors.Is(err, os.ErrPermission) {
return nil
}
return err
}
defer f.Close()
entries, _ := f.ReadDir(0) // ReadDir 不触发 stat，更快
for _, ent := range entries {
entPath := filepath.Join(path, ent.Name())
info, err := ent.Info()
if err != nil { continue } // 权限问题跳过单个 entry
if ent.IsDir() {
if ino, ok := getIno(info); ok {
if visited[ino] {
continue // 已见过，跳过循环
}
visited[ino] = true
}
if err := walkSafe(entPath, depth+1, visited); err != nil {
return err
}
}
}
return nil
}
Windows 下符号链接和重解析点的特殊处理
Go 的 os.FileInfo 在 Windows 上无法可靠区分 symlink 和 junction，filepath.Walk 默认不跟随重解析点，但手写递归时若调用 os.Stat 可能触发跟随，导致意外遍历系统目录（如 C:\Users\All Users）。
- 始终用
os.Lstat替代os.Stat获取原始文件信息，避免自动解引用 - 检查
info.Mode()&os.ModeSymlink != 0只是必要非充分条件；Windows junction 需额外判断info.Sys().(*syscall.Win32FileAttributeData).FileAttributes & syscall.FILE_ATTRIBUTE_REPARSE_POINT - 生产环境建议统一禁用跟随：对疑似 symlink 路径，直接
filepath.SkipDir或记录后跳过
真正麻烦的不是代码多，而是不同 OS 对“同名操作”的语义差异——比如 os.ReadDir 在 macOS 返回 symlink 目录项，但 ent.IsDir() 仍为 true；而 Windows junction 在 ent.IsDir() 也返回 true，但底层指向完全无关路径。
