filepath.WalkDir（Go 1.16+）可正确处理符号链接，通过fs.DirEntry.IsSymlink()判断并手动跳转，避免误判；旧版本需自行封装递归逻辑，且须用filepath.Join拼接路径、妥善处理error返回值与权限错误。
filepath.Walk 会跳过符号链接，除非显式处理
默认情况下 filepath.Walk 不会进入符号链接指向的目标目录，而是把链接本身当作一个普通文件（或空目录）处理。这在构建文件扫描工具时容易误判——比如你明明想递归检查 /usr/local/bin 下所有可执行文件，却漏掉了通过 symlink 指向的脚本。
解决办法是改用 filepath.WalkDir（Go 1.16+），它返回 fs.DirEntry，能通过 entry.Type().IsSymlink() 判断，并手动调用 os.Readlink 和 filepath.Join 跳转：
err := filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
if err != nil {
return err
}
if d.Type().IsSymlink() {
target, _ := os.Readlink(path)
absTarget := filepath.Join(filepath.Dir(path), target)
// 这里可以决定是否继续 WalkDir(absTarget)
}
return nil
})
- 旧项目还在用 Go 1.15 及以下？只能自己封装递归逻辑，
filepath.Walk无法绕过这个限制 -
filepath.WalkDir比filepath.Walk更轻量，不强制 Stat 每个文件，性能更好 - 注意循环软链：如果 A → B → A，不加路径深度/已访问集合检测会无限递归
error 返回值控制遍历流程，别直接 panic 或忽略
filepath.Walk 和 filepath.WalkDir 的回调函数返回 error，这个值不是用来“上报错误”的，而是用来**中断遍历**：返回非 nil error 会立刻停止后续遍历；返回 filepath.SkipDir 会跳过当前目录但继续其他分支。
常见错误是把 IO 错误（比如权限不足）直接 panic 或静默吞掉：
立即学习“go语言免费学习笔记（深入）”；
// ❌ 错误：遇到 /root/.ssh 就 panic，整个程序挂了
if strings.Contains(path, ".git") {
panic("skip git dir")
}
// ✅ 正确：跳过该目录，继续处理兄弟目录
if strings.Contains(path, ".git") {
return filepath.SkipDir
}
- 权限错误（
permission denied）很常见，应返回nil继续，或记录日志后返回filepath.SkipDir - 不要在回调里 recover panic——
Walk不捕获 panic，会导致整个 goroutine 崩溃 - 若需收集全部错误，得在外层定义切片，在回调中 append，而不是依赖 error 返回值
路径拼接必须用 filepath.Join，别用字符串 +
Windows 下路径分隔符是 \，Linux/macOS 是 /。硬拼 path + "/" + name 在 Windows 上会产生 C:\foo/bar 这种混合分隔符路径，后续 os.Stat 或 os.Open 很可能失败，且错误信息模糊（比如 file does not exist，实际是路径格式错）。
filepath.Join 自动适配系统规则，还做冗余分隔符清理：
// ❌ 危险 subPath := path + "/" + d.Name() // ✅ 安全 subPath := filepath.Join(path, d.Name())
- 即使输入里已有尾部
/，filepath.Join("a/", "b")仍输出a/b（Unix）或a\b（Windows） - 跨平台 CLI 工具、配置文件路径解析等场景，漏掉这一步，Windows 用户第一反馈就是“找不到文件”
- 注意：
filepath.Clean不等价于Join，它只规范化，不处理分隔符逻辑
并发遍历目录？Walk 本身不支持，得自己拆任务
filepath.Walk 和 filepath.WalkDir 都是单 goroutine 同步遍历，没法开多线程加速。想提速只能自己按子目录分片，用 sync.WaitGroup 或 errgroup.Group 并发调用多次 WalkDir。
但要注意：目录结构不是均匀树，根目录下几个大目录可能占 90% 时间，简单按字母分片（如 a–f、g–m…）效果很差。
- 更靠谱的做法是先用一次
WalkDir收集所有子目录路径，再按预计大小（或子项数量）分组 - 并发数别盲目设高——太多 goroutine 争抢磁盘 I/O，反而比单线程慢
- 如果目标是“快速找到某个文件”，建议用
find（Linux/macOS）或where（Windows）命令外包，比纯 Go 实现快得多
