最常用且高效的做法是先用 regexp.Compile 显式编译正则，再复用 *regexp.Regexp 实例调用 MatchString；用户输入或配置项必须用 Compile 并检查 err，硬编码才可用 MustCompile；匹配文件名用 f.Name()，匹配路径结构用 path；中文匹配推荐宽范围 Unicode 字符集或 unicode.Is(unicode.Scripts["Han"], r)；权限错误应改用 WalkDir 并在回调中返回 nil 继续遍历。
regexp.Compile 和 regexp.MatchString 的组合最常用
直接用 regexp.MatchString 虽然方便，但每次调用都会隐式编译正则，对高频文件遍历（比如扫描上万文件）会造成明显性能损耗。真正灵活又可控的做法是：先用 regexp.Compile 显式编译一次，再复用返回的 *regexp.Regexp 实例调用 MatchString。
常见错误现象：regexp.MustCompile 在 pattern 有语法错误时 panic，而命令行传入的正则往往是用户输入——不能假设它合法。所以运行时生成的 pattern 必须用 Compile 并检查 err。
- 若 pattern 来自配置文件或 CLI 参数，一律用
regexp.Compile(pattern)+if err != nil判断 - 若 pattern 是硬编码、不会变（如
`^config\..*\.yaml$`），可用regexp.MustCompile省去错误处理 - 注意：Go 的 regexp 使用 RE2 引擎，不支持
\1回溯引用、(?i)内联标志等 PCRE 特性；大小写忽略请改用(?i:pattern)或提前转小写
匹配文件名还是完整路径？关键看 filepath.Walk 的 path 参数
filepath.Walk 回调函数中传入的 path 是绝对或相对完整路径（如 "./logs/app-2024-06-01.log"），而 f.Name() 只是纯文件名（如 "app-2024-06-01.log"）。选哪个做正则匹配，取决于你的过滤意图：
- 只筛文件名（如所有
.go文件）：用re.MatchString(f.Name()) - 按目录结构筛选（如
**/testdata/*.json）：必须用re.MatchString(path)，并确保正则包含路径分隔符逻辑（注意 Windows 和 Unix 路径分隔符差异） - 想兼顾两者又不想写两套逻辑？可统一用
filepath.Base(path)提取文件名再匹配，比正则处理完整路径更稳定
中文文件名匹配容易出错的三个点
用正则匹配含中文的文件名时，[\u4e00-\u9fa5] 是最常被抄错的写法——它漏掉大量实际存在的汉字和标点，且在 Go 中可能触发 invalid UTF-8 错误。
- 错误根源：字符串本身含非法 UTF-8 字节（比如从 GBK 编码文件名读取后未转码），不是正则写错了；
regexp.Compile报这个错，第一反应应查输入源编码 - 宽松匹配中文推荐范围：
[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff\u3000-\u303f\uff00-\uffef]，覆盖基本汉字、扩展 A/B、兼容汉字、中文标点 - 真要严格判断“是否汉字”？别依赖正则。用
unicode.Is(unicode.Scripts["Han"], r)逐 rune 判断，配合strings.Map或手动遍历
避免 filepath.Walk 遇到权限错误就中断
filepath.Walk 默认遇到 os.ErrPermission 会停止遍历，导致子目录完全跳过。这不是 bug，是设计行为——但多数文件搜索工具需要继续往下走。
- 解决方案：不用
filepath.Walk，改用filepath.WalkDir（Go 1.16+），它传入的是fs.DirEntry，错误由回调函数返回控制 - 在回调里判断
err是否为os.ErrPermission，若是，返回nil继续遍历；其他错误才返回原err - 注意：
WalkDir不会自动打开子目录，需手动调用ReadDir，但换来的是细粒度错误控制和更低内存占用
真正灵活的文件正则过滤，不在正则多复杂，而在清楚知道每个 API 的边界：什么时候该预编译、path 和 Name 怎么选、中文怎么防漏、权限错误怎么吞。这些点一旦写错，轻则漏匹配，重则程序 panic 或静默失败——而它们全藏在几行代码的参数和条件分支里。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
