Golang实战：本地文件搜索工具_实现递归扫描与文件名匹配

go 1.16+ 应无条件选 filepath.walkdir，它用 io/fs.readdir 避免冗余 stat 调用、快 20%–40%，支持 fs.skipdir 跳过权限不足目录，且需注意 direntry 轻量、不触发 stat。

用 filepath.WalkDir 还是 filepath.Walk？

Go 1.16+ 应该无条件选 filepath.WalkDir。它默认使用 io/fs.ReadDir，避免了 filepath.Walk 那种先 stat 再判断是否为目录的冗余系统调用，在大目录下快 20%–40%，而且能天然跳过权限不足的子目录（返回 fs.SkipDir 错误即可）。

常见错误：有人把 filepath.Walk 的回调函数签名（func(path String, info os.FileInfo, err Error) error）直接套到 filepath.WalkDir 上——后者第二个参数是 fs.DirEntry，轻量、不触发 stat，但不能直接读 ModTime() 或 Size()。

• 需要文件大小或修改时间？必须显式调用 entry.Info()，这会触发一次 stat
• 只匹配文件名？直接用 entry.Name()，零开销
• 想跳过某个目录？在回调里 return fs.SkipDir，不是 nil 或 errors.New("skip")

文件名匹配该用 strings.Contains 还是 path.Match？

看场景：模糊子串搜“log”“conf”这种，用 strings.Contains(entry.Name(), keyword) 最直白；要支持通配符（如 *.go、test_?.txt），必须用 path.Match(pattern, entry.Name())。

容易踩的坑：path.Match 不支持正则，也不支持 ** 这种双星递归匹配——它只认 *（任意字符）、?（单字符）、[abc]（字符集）。想实现 **/*.go？得自己解析 pattern，或换用第三方库如 golang.org/x/exp/filepath（非稳定）。

立即学习“go语言免费学习笔记（深入）”；

• 区分大小写：windows 默认不区分，linux/macos 区分——strings.Contains 是严格字节匹配，path.Match 同样严格
• 想忽略大小写搜？用 strings.Contains(strings.ToLower(entry.Name()), strings.ToLower(keyword))
• 匹配前先检查是否为文件：!entry.IsDir()，否则你会把目录名也当结果返回

怎么安全中断扫描又不 panic？

filepath.WalkDir 的回调函数返回非 nil error 时，会立即停止遍历并把该 error 当作整个调用的返回值。所以别用 panic 或 os.Exit 停止——用户按 Ctrl+C 时应优雅退出，而不是崩掉。

正确做法是传入一个带 cancel 的 context.Context，并在每次回调开头检查 ctx.Err() != nil。但注意：filepath.WalkDir 本身不接受 context，得靠外部控制流。

• 启动 goroutine 执行 WalkDir，主 goroutine 监听 os.interrupt 信号，发 cancel
• 回调里每处理几百个文件就 select 检查一次 ctx.Done()，及时 return ctx.Err()
• 不要在回调里做耗时操作（比如打开每个文件读内容），否则中断响应延迟严重

输出结果顺序为什么和磁盘不一致？

filepath.WalkDir 按操作系统底层目录迭代顺序返回，Linux ext4 通常是哈希乱序，macOS APFS 更不可预测。如果你期望按字母序或时间序展示，必须在收集完所有匹配项后再排序。

性能影响明显：边走边 append 到 slice，最后 sort.Slice(res, func(i, j int) bool { return res[i].Name ，比在回调里反复插入排序快得多。

• 只排文件名？用 strings.Compare(a.Name, b.Name)
• 想按修改时间排？得提前调用 entry.Info() 并缓存 ModTime()，否则排序时再调会重复 stat
• 大量结果（>10 万）？考虑用 heap 做 top-K，避免全量内存排序

最常被忽略的一点：递归扫描时，符号链接默认会被跟随。如果目标路径存在循环软链（比如 A → B → A），WalkDir 会卡死或爆栈。启动前加一句 filepath.WalkDir 不处理 symlink，得自己在回调里用 entry.Type() & fs.ModeSymlink != 0 跳过，或者用 os.Stat + os.IsSymlink 预检。这事儿没人提醒，但线上跑进死循环就只能 kill -9 了。