filepath.Walk 默认跳过 symlink 目录，而 WalkDir（Go 1.16+）支持显式处理：通过 fs.DirEntry 判断 symlink 并手动递归，配合正确 error 返回（如 SkipDir 或 nil）避免遍历中断。
filepath.Walk 会跳过 symlink 目录，除非显式处理
默认情况下 filepath.Walk 遇到符号链接（symlink）指向目录时直接跳过，不会进入其内部。这不是 bug，而是设计行为——它只遍历“真实路径”，避免循环引用或权限问题。
如果需要跟随 symlink，得改用 filepath.WalkDir（Go 1.16+），它提供更可控的遍历方式，并允许你在回调中主动调用 os.Readlink 和 filepath.Join 构造新路径再递归。
- 旧代码用
filepath.Walk无法开启 follow-symlink，强行绕过会破坏路径一致性 -
filepath.WalkDir返回的是fs.DirEntry，可通过entry.Type().IsDir() && entry.Type()&os.ModeSymlink != 0判断 symlink 目录 - 对 symlink 目录调用
os.Stat可获取目标信息，但递归时需手动拼接路径，注意用filepath.Clean防止路径污染
WalkDir 的 error 处理逻辑决定是否中断遍历
filepath.WalkDir 的回调函数返回 error，这个值直接影响后续遍历：返回 filepath.SkipDir 会跳过当前目录下所有子项；返回其他非 nil error（如 errors.New("stop now")）则整个遍历立即终止。
常见误操作是把 I/O 错误（如权限拒绝）原样返回，导致本可继续的兄弟目录也被截断。合理做法是仅对真正不可恢复的错误 panic 或提前 return，其余错误就地记录并返回 nil。
立即学习“go语言免费学习笔记（深入）”；
- 权限不足（
os.ErrPermission）建议 log 后返回nil，否则 /proc /sys 等受限目录会让整个扫描失败 - 遇到
os.ErrNotExist通常说明路径被并发删除，返回nil继续即可 - 若想跳过某类扩展名目录（如
.git），在回调开头判断路径后直接 returnfilepath.SkipDir
err := filepath.WalkDir("/path", func(path string, d fs.DirEntry, err error) error {
if err != nil {
if errors.Is(err, os.ErrPermission) {
log.Printf("skip %s: permission denied", path)
return nil
}
return err // 其他错误才中断
}
if d.IsDir() && d.Name() == ".git" {
return filepath.SkipDir
}
// ... 处理文件
return nil
})
Walk 和 WalkDir 在路径拼接上行为一致，但类型安全不同
两者都使用 filepath.Join 拼接子路径，所以相对路径处理逻辑完全一致。区别在于：Walk 回调参数是 os.FileInfo，而 WalkDir 是 fs.DirEntry —— 后者不强制 stat，性能更好，尤其在只需要文件名和类型时。
如果你只关心名字和是否为目录，用 DirEntry 可避免大量 stat 系统调用；但一旦需要修改时间、大小等字段，就必须调用 d.Info()，这时性能优势消失。
-
DirEntry.Name()返回不含路径的文件名，DirEntry.IsDir()不触发系统调用 -
FileInfo.Name()也只返回 basename，但FileInfo本身已是stat结果 - 跨平台路径分隔符由
filepath包自动处理，无需手动替换/或\
并发遍历目录容易触发 open too many files 错误
Go 的 filepath.WalkDir 本身是同步阻塞的，但很多人会外层加 goroutine 并发处理多个根目录，比如扫描多个磁盘分区。这时若未限制并发数，很容易触发 too many open files —— 因为每个 goroutine 在遍历中持续打开目录句柄（opendir），直到递归完成才释放。
解决方法不是减少 goroutine 数量，而是用带缓冲的 channel 控制并发度，并确保每个 WalkDir 调用完成后及时释放资源（它本身会 close dir handle，但大量并发仍会堆积）。
- 用
semaphore包或带缓冲 channel 控制同时活跃的WalkDir数量（建议 ≤ 4） - 避免在回调里启动 goroutine 处理单个文件，这会让句柄生命周期更难预测
- Linux 上可通过
ulimit -n查看当前限制，临时调高只是掩盖问题，不解决根本
