filepath.Walk默认跳过符号链接且不检测循环引用，需手动用os.Readlink和os.Stat处理symlink并维护已访问路径集防无限递归；返回非nil error仅中断当前分支，filepath.SkipDir跳过子目录，SkipAll终止全部遍历。
filepath.Walk 会跳过 symlink，且不自动处理循环引用
默认情况下 filepath.Walk 不跟随符号链接（symlink），也不会检测目录循环（比如软链指向父目录），遇到 symlink 就直接跳过；如果目标是遍历真实路径结构（含 symlink 指向的内容），必须手动用 os.Stat 和 os.Readlink 判断并递归处理——否则你会漏掉一部分文件，还可能触发无限递归。
常见错误现象：filepath.Walk 突然在某个目录停止，日志没报错但结果少了几十个文件；或者程序卡住、栈溢出。
- 用
os.Lstat先判断是否为 symlink - 若为 symlink，用
os.Readlink获取目标路径，再调用filepath.Abs转成绝对路径（避免相对路径拼接出错） - 维护一个已访问路径的
map[string]bool集合，每次进入前检查是否已处理过该绝对路径 - 注意：不同 OS 对 symlink 的行为略有差异，Linux/macOS 默认不跟随，Windows 的 junction point 需额外用
os.IsSymlink+syscall判断
WalkFunc 回调里不能直接修改 path 参数，否则影响后续遍历
filepath.Walk 传给回调函数的 path 是内部复用的字符串，不是每次新建；如果你在 WalkFunc 里对它做 strings.Replace 或截断操作并保存引用，下一轮迭代时这个变量可能已被覆盖，导致路径错乱或 panic。
典型误用：base := path[len(root)+1:] // 假设 root 是 "/tmp" —— 这种切片依赖原始字符串生命周期，一旦 path 被复用就失效。
立即学习“go语言免费学习笔记（深入）”；
- 所有路径处理逻辑，先用
string(path)显式拷贝一份再操作（虽然开销小，但安全） - 需要提取 basename 或 dir 名时，优先用
filepath.Base/filepath.Dir，它们内部已做拷贝 - 若需过滤或提前退出，返回非 nil error（如
errors.New("skip")），但注意：只有 error != nil 才中断当前分支，不是全局终止
filepath.Walk 不支持并发，大量小文件时性能差
filepath.Walk 是纯同步 DFS 实现，单 goroutine 串行访问每个文件/目录，磁盘 I/O 完全无法重叠。在 SSD 上遍历 10 万个小文件可能要几秒，在 HDD 上更慢；而并发版（如用 filepath.WalkDir + goroutines）能轻松提升 3–5 倍吞吐。
Go 1.16+ 提供了 filepath.WalkDir，它返回 fs.DirEntry，可避免部分 os.Stat 调用，配合 worker pool 效果更好。
- 优先用
filepath.WalkDir替代filepath.Walk，尤其在 Go ≥ 1.16 环境下 - 不要为每个文件启一个 goroutine（易 OOM），用固定数量 worker（如 runtime.NumCPU()）+ channel 分发路径
- 注意：并发遍历时，
os.FileInfo必须在 goroutine 内调用os.Stat获取，不能复用 WalkDir 返回的fs.DirEntry的 Info() 结果（某些文件系统下可能过期）
错误处理容易忽略 os.SkipDir 和 filepath.SkipDir 的区别
返回 filepath.SkipDir 只跳过当前目录的子项遍历，但继续走同级其他目录；而 os.SkipDir 是底层 syscall 错误码，filepath.Walk 内部识别后也转成 filepath.SkipDir 行为——但你不能直接 return os.SkipDir，否则类型不匹配，编译不过。
常见混淆点：看到文档写 “return os.SkipDir”，其实是旧版误传；实际只能 return filepath.SkipDir（它是 error 类型的预定义变量）。
- 想跳过某个目录（比如
.git或node_modules），在回调里判断后 returnfilepath.SkipDir - 想跳过整个遍历，return 任意非
nilerror（如fmt.Errorf("stop now")） - 遇到权限拒绝（
os.ErrPermission）时，默认会继续遍历兄弟目录；若想静默跳过，需显式捕获并 returnnil（不推荐）或filepath.SkipDir（仅对目录生效）
