filepath.WalkDir 是 Go 1.16+ 推荐的目录遍历方式，支持 symlink 展开、细粒度控制（如跳过 node_modules）、按需 stat、权限错误恢复，而 filepath.Walk 跳过 symlink 目录、深度优先不可控、易误判目录类型。
filepath.Walk 会跳过 symlink 目录，且无法控制遍历顺序
它用 os.Lstat 获取入口信息，遇到符号链接时默认不展开（除非目标是文件），且整个遍历过程是深度优先、不可中断、不可跳过子树的。如果你需要进入 symlink 指向的目录，或者想在某个子目录下提前退出，filepath.Walk 做不到。
常见错误现象：filepath.Walk 遍历时发现某目录“消失”了——其实是该路径是个 symlink，而它被直接忽略；或者你想按字母序先处理 docs/ 再处理 src/，但它硬是按系统 readdir 返回顺序来，没法干预。
- 只适合简单扫描，比如收集所有
.go文件路径 - 回调函数签名是
func(path string, info os.FileInfo, err error) error，err 是读取失败时的错误，返回非 nil 会终止遍历 - 不区分 symlink 和普通目录，
info.IsDir()对 symlink 返回 false，容易误判
filepath.WalkDir 是 Go 1.16+ 推荐方式，支持 symlink 展开和细粒度控制
filepath.WalkDir 底层用 io/fs.ReadDir，返回的是 fs.DirEntry，轻量、不预加载完整 os.FileInfo，性能更好；更重要的是，它把“是否进入 symlink 目录”这件事交给你决定。
使用场景：需要安全处理软链、想跳过某些子目录（如 node_modules）、或要避免 stat 大量文件带来的开销。
立即学习“go语言免费学习笔记（深入）”；
- 回调函数是
func(path string, d fs.DirEntry, err error) error -
d.Type()可以明确判断是否为 symlink（d.Type()&os.ModeSymlink != 0） - 若想进入 symlink 目录，直接返回
nil；若不想进，返回filepath.SkipDir - 对普通目录，调用
d.Info()才触发一次stat，比Walk更省
示例片段：
err := filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
if err != nil {
return err
}
if d.Name() == "node_modules" && d.IsDir() {
return filepath.SkipDir
}
if d.Type()&os.ModeSymlink != 0 {
// 想跳过所有软链目录？这里 return filepath.SkipDir
// 想只对软链文件做特殊处理？继续往下走
}
return nil
})
遇到 permission denied 错误时，WalkDir 更容易恢复
filepath.Walk 在某个子路径上遇到 os.ErrPermission，如果回调没显式返回 nil，就会直接终止整个遍历；而 WalkDir 的 err 参数就是那个权限错误，你可以在回调里检查并吞掉它，让遍历继续下去。
- 典型错误信息：
permission denied出现在/root/.cache或/proc下 - 只需加一句
if errors.Is(err, os.ErrPermission) { return nil }就能跳过 - 注意：
WalkDir不会自动重试或递归重试子目录，错误只发生在当前 entry，不影响兄弟节点
Windows 下 symlink 行为差异大，别假设跨平台一致
Go 在 Windows 上对 symlink 的支持依赖于创建时的权限和 flag（比如是否用了 mklink /D 还是 mklink），WalkDir 能读到 symlink，但 d.Type() 可能不带 os.ModeSymlink，尤其在非管理员 CMD 创建的链接下。
- 测试时务必在目标环境跑，别只信 Linux 结果
- 不要仅靠
d.Type()判断 symlink，可 fallback 用os.Readlink(path)捕获no such file or directory来反推 - Go 1.22+ 开始，
os.Readlink在 Windows 上更稳定，但旧版本仍有坑
复杂点在于：symlink 是否可跟随、是否循环、是否跨卷，这些都得在业务逻辑里自己守门，标准库只负责暴露原始信息，不替你做决策。
