结论是别用嵌套循环比对文件名，也别在遍历里反复编译正则；应使用map[string]bool实现O(1)黑名单查找，并预编译正则、优先用strings.HasSuffix过滤固定后缀。
用 map[string]bool 替代 for 循环判断黑名单目录
常见错误是写个 avoidList := []string{"Admin", "Public", "Default"}，然后在 filepath.Walk 回调里两层 for 循环挨个比对。这不仅逻辑容易错（break 只跳出内层），而且时间复杂度是 O(n×m)，100 个待排除目录 + 10 万文件 = 百万次字符串比较。
正确做法是预加载为哈希映射：
avoidMap := map[string]bool{"Admin": true, "Public": true, "Default": true}- 判断时直接
if avoidMap[f.Name()] { return nil }，O(1) 查找，语义清晰 - Windows 下注意大小写：系统目录名实际是首字母大写，但 NTFS 不区分大小写，建议统一转小写再查：
avoidMap[strings.ToLower(f.Name())]
正则匹配文件名前必须显式编译并检查 error
用户输入、配置文件读取的正则 pattern 绝不能用 regexp.MustCompile。它会在非法 pattern 时 panic，而真实场景中用户可能输错 .*\.log$ 少个反斜杠。
应该：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
re, err := regexp.Compile(`^.*\.log$`)，并在使用前if err != nil { log.Fatal(err) } - 硬编码且确定无误的 pattern 才可简化为
regexp.MustCompile - 匹配文件名用
re.MatchString(f.Name())；匹配完整路径（如**/testdata/*.json）才用re.MatchString(path)，注意path在 Windows 下含\，建议先用filepath.ToSlash(path)统一为/
按扩展名过滤优先用 strings.HasSuffix 而非正则
只筛 .go、.md 这类固定后缀时，strings.HasSuffix(f.Name(), ".go") 比正则快 5–10 倍，且无编译开销、无语法风险。
适用场景：
- 单一后缀：直接
strings.HasSuffix(f.Name(), ".txt") - 多后缀：提前建 map：
extMap := map[string]bool{".go": true, ".mod": true}，再查extMap[filepath.Ext(f.Name())] - 通配符需求（如
*.log）才用filepath.Match，它比正则轻量，但注意它不支持**，仅单层通配
中文文件名过滤要先确认 UTF-8 编码是否合法
正则报 invalid UTF-8 错误，99% 不是正则写错了，而是文件系统返回的文件名本身含非法字节（比如从 GBK 编码目录下读取未转码）。Go 的 os.ReadDir 和 filepath.Walk 默认返回原始字节，遇到非 UTF-8 名称会直接失败。
安全做法：
- 用
os.ReadDir替代旧版ioutil.ReadDir，它对非法字节更宽容（返回FileInfo时会做基础校验） - 若需严格处理中文，先用
golang.org/x/text/encoding转码，或改用宽松正则范围：[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff\u3000-\u303f\uff00-\uffef] - 最稳妥的方式：统一用
filepath.Base(path)提取文件名后再匹配，避免路径分隔符干扰
filepath.Walk 回调里，或者把 map 初始化放在循环内部。这些细节不报错，但会让程序慢得莫名其妙。 
