推荐使用 filepath.WalkDir 而非 filepath.Walk：性能更高（避免重复 os.Stat）、控制更强（支持 filepath.SkipDir）、更安全（可主动处理权限错误、软链接环路、递归深度）；匹配逻辑应解耦为可组合的 Matcher 函数，路径判断优先用 strings.HasSuffix；结果需后排序，不依赖遍历顺序。
用 filepath.WalkDir 而不是 filepath.Walk
Go 1.16+ 默认推荐 filepath.WalkDir，它用 fs.DirEntry 避免了对每个文件都调用 os.Stat，性能提升明显，尤其在大目录下。老代码如果还用 filepath.Walk，会多出大量系统调用，拖慢查找速度。
常见错误现象：filepath.Walk 在遇到权限不足的子目录时直接 panic 或中断遍历；而 filepath.WalkDir 允许你在回调里返回 filepath.SkipDir 主动跳过，控制力更强。
- 只读取目录结构信息时，
DirEntry的IsDir()和Name()就够用，无需os.Stat - 需要文件大小或修改时间等元数据时，才对目标路径显式调用
os.Stat - 若需兼容 Go 1.15 及更早版本，得降级用
filepath.Walk，但必须自己缓存os.FileInfo防重复 stat
过滤逻辑别写死在 Walk 回调里
把匹配条件（比如后缀名、文件大小范围、正则模式）抽成独立函数，而不是在 WalkDir 的回调里硬编码判断。否则一加新规则就得改遍历逻辑，耦合高、难测试、没法复用。
使用场景：你可能既要找 .log 文件，又要排除 /tmp 下的所有内容，还要支持忽略隐藏文件——这些规则应可组合、可开关。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 定义类型如
type Matcher func(path string, d fs.DirEntry) bool，多个 matcher 用&&或||组合 - 路径匹配优先用
strings.HasSuffix(d.Name(), ".go")，而非path.Ext(path) == ".go"，避免误判my.go.bak - 正则匹配建议预编译
*regexp.Regexp，别在每次回调里regexp.Compile，否则性能暴跌
递归深度控制和软链接处理要主动做
默认 filepath.WalkDir 不限制深度，也不自动检测循环软链接。真实环境里，/proc/self/fd 或用户手动创建的软链环路会导致无限递归、栈溢出或卡死。
错误现象：程序突然占用 100% CPU，strace 显示反复 openat 同几个路径；或者报 runtime: goroutine stack exceeds 1000000000-byte limit。
- 用闭包变量记录当前深度，每进一层目录 +1，超阈值（如 32）就返回
filepath.SkipDir - 对软链接调用
os.Readlink，再用filepath.IsAbs和filepath.Join判断是否指向已访问过的绝对路径 - 不建议依赖
os.FileInfo.Sys().(*syscall.Stat_t).Ino做 inode 去重——Windows 没 inode，且不同挂载点可能碰撞
输出结果顺序不可靠，别假设按目录树顺序
filepath.WalkDir 不保证遍历顺序，Linux 下常是乱序（底层依赖 getdents），macOS 更甚。如果你希望结果按路径字典序排列，或按修改时间倒序，必须在收集完所有匹配项后再排序。
性能影响：边走边 append 到 slice 再 sort.Slice，内存开销可控；但若用 container/heap 实时维护 Top-K，反而得不偿失，除非明确只要前 10 个最新文件。
- 简单排序示例：
sort.Slice(matches, func(i, j int) bool { return matches[i].Path - 时间排序需先调用
os.Stat获取ModTime()，注意错误处理，避免因权限问题 panic - 命令行工具建议加
-sort name/time/size参数，而不是默认强求某一种顺序
递归遍历看着简单，真正上线跑进用户家目录时，软链、权限、深度、顺序这四点，漏掉任何一个都会让工具在特定机器上静默失败或失控。别依赖“本地测试能跑通”。
