推荐用 filepath.WalkDir 而非已弃用的 filepath.Walk，因其基于 fs.DirEntry 避免 stat 开销、支持跳过子目录、能准确区分文件/目录类型；后缀过滤应统一转小写后用 strings.HasSuffix，而非 filepath.Ext；并发仅用于后续处理，路径操作须用 filepath.Join 和 filepath.ToSlash 保证跨平台。
用 filepath.WalkDir 遍历，别用已弃用的 filepath.Walk
Go 1.16+ 推荐用 filepath.WalkDir，它基于 fs.DirEntry，避免了 stat 调用开销，且能跳过子目录。旧版 filepath.Walk 在遍历中无法区分文件/目录类型，容易误判或重复 stat —— 尤其当目标路径含符号链接时，filepath.Walk 可能触发循环或权限错误。
关键点：
-
filepath.WalkDir的回调函数接收fs.DirEntry，调用entry.IsDir()判断类型，比os.Stat快； - 返回非 nil error 会中断遍历，返回
filepath.SkipDir可跳过当前目录（比如.git）； - 不要在回调里对
path再次调用os.Stat，除非你明确需要完整os.FileInfo（比如获取修改时间）。
过滤后缀：用 strings.HasSuffix，不是 filepath.Ext
filepath.Ext 返回包括点号的后缀（如 ".go"），而用户常传入不含点的字符串（如 "go" 或 "log"）。直接比对 filepath.Ext(path) == ".go" 容易漏掉配置项写错的情况；更稳妥的是统一转小写 + strings.HasSuffix。
示例逻辑：
立即学习“go语言免费学习笔记（深入）”；
exts := map[string]bool{"go": true, "mod": true, "sum": true}
name := strings.ToLower(filepath.Base(path))
for ext := range exts {
if strings.HasSuffix(name, "."+ext) {
// 匹配
break
}
}
注意：
- 后缀匹配要区分大小写，Linux 下
README.MD和readme.md可能共存，建议统一转小写处理； - 避免用正则匹配后缀——简单后缀无需正则，性能差且易写错边界（比如
.*.go$会误中main.go.bak）； - 如果需求是“排除某后缀”，直接在匹配逻辑里取反，别在遍历后二次过滤。
并发遍历？别轻易加 goroutine
文件系统 I/O 是瓶颈，不是 CPU。盲目对每个目录启 goroutine 不仅不会提速，反而因调度开销和 fd 耗尽导致失败（尤其在大量小文件场景下）。真正需要并发的只有“后续处理”（比如读取并解析每个匹配到的 .go 文件内容）。
推荐做法：
- 用单 goroutine 调用
filepath.WalkDir收集所有匹配路径到切片； - 再用
sync.Pool或固定 worker 数（如runtime.NumCPU()）并发处理这些路径； - 若必须边遍历边处理，用带缓冲的 channel 控制并发数（缓冲大小建议设为 100–1000），避免 channel 堵塞或内存暴涨。
Windows 路径分隔符问题：用 filepath.Join 和 filepath.ToSlash
在 Windows 上，filepath.WalkDir 返回的 path 使用反斜杠 ，而很多工具链（如正则、HTTP 路由、日志打印）默认适配正斜杠 /。硬编码 "\" 或 "\." 会导致跨平台逻辑断裂。
安全做法：
- 路径拼接一律用
filepath.Join(root, "sub", "file.go")，而非字符串拼接； - 输出或调试时转成统一格式：
filepath.ToSlash(path)； - 后缀过滤逻辑不依赖路径分隔符，只作用于
filepath.Base(path)结果，天然跨平台。
实际项目里最容易被忽略的，是把过滤逻辑耦合进路径拼接或字符串切分——只要坚持用 filepath.Base 提取文件名、用 strings.HasSuffix 判断后缀，就基本不会栽在 Windows 换行或分隔符上。
