filepath.WalkDir比Walk更值得优先使用，因其复用ReadDir的fs.DirEntry避免重复os.Stat调用，性能提升2–5倍，且默认不跟随符号链接更安全；仅需文件名、类型时应首选WalkDir。
filepath.WalkDir 为什么比 Walk 更值得优先用
Go 1.16 引入 filepath.WalkDir，核心优势是避免为每个文件都做 os.Stat 系统调用——它直接复用 ReadDir 返回的 fs.DirEntry，省掉一次 syscall。尤其在大目录或 NFS 挂载路径下，性能差距明显（实测快 2–5 倍）。filepath.Walk 内部仍会为每个路径调用 os.Stat，哪怕你只关心名字和是否是目录。
常见错误现象：filepath.Walk 在遇到符号链接循环时容易 panic 或卡死；而 WalkDir 默认不跟随符号链接，天然更安全。
- 如果你只需要文件名、类型（目录/文件）、是否是符号链接，就用
WalkDir，别碰Walk - 如果必须依赖
os.FileInfo的完整信息（比如修改时间、权限位），才考虑Walk，但记得加defer和错误恢复逻辑 -
WalkDir的回调函数签名是func(path string, d fs.DirEntry, err error) error，注意d是fs.DirEntry，不是os.FileInfo
如何正确判断目录、文件、符号链接
fs.DirEntry 提供 IsDir()、Type() 和 Info() 三种方式，但行为不同：前两者轻量且无副作用；Info() 会触发一次 os.Stat，失去 WalkDir 的性能优势。
使用场景：遍历中跳过 .git、node_modules 这类目录，或只处理 .go 文件，都不需要 Info()。
立即学习“go语言免费学习笔记（深入）”；
- 用
d.IsDir()判断是否为目录（返回 bool） - 用
d.Type() & os.ModeSymlink != 0判断是否为符号链接（Type()返回的是模式位掩码） - 避免写
d.Info().IsDir()—— 它多一次系统调用，且可能因权限不足返回 error - 若真需文件大小或 modtime，只对目标文件调用
d.Info()，并检查 error
错误处理不能只 return nil
很多人写 WalkDir 回调时，一看到 err != nil 就直接 return nil，结果是整个遍历静默终止，连错误日志都没有。更糟的是，某些 I/O 错误（如 permission denied）本应跳过该路径继续，但返回 nil 会让 walk 停在当前层级。
错误类型分两类：可恢复（如 fs.SkipDir、fs.SkipAll）和不可恢复（如磁盘 I/O 错误）。关键在区分对待。
- 遇到权限错误（
os.ErrPermission）或不存在（os.ErrNotExist），应返回fs.SkipDir（如果是目录）或忽略（如果是文件） - 想彻底中止遍历，返回非 nil error（如
errors.New("stop now")） - 想记录错误但继续，打印日志后 return nil —— 但仅限明确知道可跳过的错误
- 永远不要忽略
err参数：即使d非 nil，err也可能非 nil（例如目录打开失败但路径有效）
递归进子目录前要检查 d.IsDir() && !d.IsRegular()
看起来矛盾？其实不然：d.IsDir() 只表示“这个条目指向一个目录”，但它可能是符号链接。而 d.Type() & os.ModeSymlink != 0 才说明它是链接。如果不加区分就递归，可能陷入符号链接循环（比如 /tmp/link → /tmp）。
默认情况下 WalkDir 不跟随符号链接，所以 d.IsDir() 为 true 的，一定是真实目录。但如果你手动调用了 os.ReadDir 或做了其他操作，就得自己守规矩。
- 标准
WalkDir回调里，只要d.IsDir()为 true，就可以安全递归（它不会把符号链接当目录传进来） - 但如果你用
filepath.Walk或自己写递归，就必须显式检查d.Type() & os.ModeSymlink == 0 - 路径拼接务必用
filepath.Join(root, d.Name())，别用字符串拼接，否则 Windows 下出错 - 注意：空目录也会触发回调，
d存在但d.Name()是 "." 或 ".." 的情况已被WalkDir过滤，不用额外处理
最常被忽略的一点：WalkDir 不保证遍历顺序，也不保证并发安全。如果需要排序，得自己收集后 sort.Strings；如果要在回调里启 goroutine 处理文件，记得对共享变量加锁或用 channel 控制。这些细节不报错，但会让结果难以预测。
