filepath.WalkDir 更轻量高效，因使用 fs.DirEntry 避免强制 Stat()，性能提升 20%~40%，但需手动控制跳过目录、过滤文件、处理错误；推荐用 strings.HasSuffix(d.Name(), ext) 快速匹配扩展名，避免 Info() 和路径误用。
filepath.WalkDir 是 Go 1.16+ 推荐的替代 filepath.Walk 的函数，它更轻量、不依赖 os.FileInfo，适合快速扫描大量文件——但直接用它找特定扩展名时，容易因忽略遍历控制或错误处理而变慢甚至 panic。
为什么不用 filepath.Walk 而选 WalkDir？
filepath.WalkDir 使用 fs.DirEntry 接口，只在需要时才调用 Stat()，避免了 filepath.Walk 强制读取完整 os.FileInfo 的开销。尤其在目录层级深、文件极多时，性能差异明显（实测快 20%~40%）。但它默认不跳过子目录，也不自动过滤，必须手动控制。
- 若你只需要文件名和扩展名，
DirEntry.Name()和DirEntry.IsDir()就够了，完全不用Stat() - 如果误在回调里对每个 entry 都调
entry.Info()，就抵消了性能优势 -
WalkDir的 error 返回值是“当前路径”的错误（如权限拒绝），不是全局中断，需显式判断是否继续
如何高效匹配 .go 或 .md 文件？
核心是利用 DirEntry.Name() 提取后缀，并在进入子目录前提前跳过无关路径。不要等进到目录里再逐个判断文件——那样会多走很多路。
- 用
strings.HasSuffix(entry.Name(), ".go")判断文件名后缀，比path.Ext()更快（后者要解析完整路径） - 对目录：若确定不需要进入（比如叫
node_modules或.git），返回filepath.SkipDir - 对文件：仅当
!entry.IsDir()且后缀匹配时才收集，避免把同名目录当文件处理 - 注意大小写：
".GO"和".go"不同，如需忽略大小写，用strings.EqualFold(strings.ToLower(ext), strings.ToLower(target))
常见错误：panic: runtime error: invalid memory address 或空结果
典型原因是传入了非法路径（如空字符串、相对路径未 resolve）或在回调里修改了正在遍历的 slice（虽然少见，但并发调用时可能）。更常被忽略的是：没有检查 err 参数是否为非 nil 的 I/O 错误，导致后续逻辑基于脏数据运行。
- 务必先检查
err != nil：如果是os.ErrPermission，可选择跳过（返回nil），而不是直接 panic - 不要把
filepath.WalkDir的第一个参数写成"."就完事——如果当前工作目录被删或权限变更，会出错；建议用filepath.Abs(dir)先转绝对路径 - 别在回调里对同一个
DirEntry多次调Info()：它内部可能重新 stat，且返回新对象，两次调用结果未必一致 - 扩展名带点是惯例，但用户输入可能是
"go"，记得补"."再比较，否则"log"也会匹配"log.go"
一个可用的最小实现
以下代码只做两件事：跳过隐藏目录、收集指定后缀的绝对路径，全程不调 Info()。
func findFiles(dir, ext string) ([]string, error) {
var matches []string
err := filepath.WalkDir(dir, func(path string, d fs.DirEntry, err error) error {
if err != nil {
if errors.Is(err, os.ErrPermission) {
return nil // 跳过无权限目录
}
return err
}
if d.IsDir() {
if strings.HasPrefix(d.Name(), ".") { // 跳过 .git、.vscode 等
return filepath.SkipDir
}
return nil
}
if strings.HasSuffix(d.Name(), ext) {
matches = append(matches, path)
}
return nil
})
return matches, err
}
// 调用示例：findFiles("/tmp", ".go")
扩展名必须带点（如 ".go"），否则逻辑失效；实际使用时建议加一层封装，统一处理 ext 输入（自动补点、转小写等）。真正难的不是写出来，而是想清楚哪些目录该跳、哪些错误该吞、哪些路径该 resolve——这些决策点，比函数调用本身影响更大。
