filepath.Walk比os.ReadDir更适合构建文件索引，因其内置深度优先递归、自动处理符号链接循环和权限错误，并支持通过返回filepath.SkipDir安全跳过指定目录；而os.ReadDir仅单层遍历，手动递归易出错且缺乏健壮性。
为什么 filepath.Walk 比 os.ReadDir 更适合构建文件索引
构建文件索引的核心是遍历全路径树，而非单层目录。虽然 os.ReadDir 在 Go 1.16+ 中性能更好、内存更省，但它只读取单层，递归逻辑需手动维护，容易漏掉深层嵌套或 symlink 循环；而 filepath.Walk 内置深度优先遍历 + 错误回调 + 跳过控制（通过返回 filepath.SkipDir），更适合索引场景。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
filepath.Walk遍历时，务必检查err != nil—— 常见于权限拒绝（permission denied）或路径被移除，不处理会导致索引中断 - 若需跳过特定目录（如
.git、node_modules），在 walk 函数中判断info.IsDir() && info.Name() == ".git"后返回filepath.SkipDir - 避免在 walk 函数里做耗时操作（如哈希计算、数据库写入），否则拖慢整个遍历；建议先收集
FileInfo或路径字符串，再批量处理
如何安全地提取文件内容特征用于搜索匹配
纯路径名搜索够快但弱，加内容特征（如首 1KB、MIME 类型、文本关键词）才能支持“包含某段代码的 .go 文件”这类需求。但直接 os.ReadFile 所有文件会 OOM 或触发大量磁盘 I/O。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 对大文件（>1MB）跳过全文读取，改用
io.LimitReader(f, 1024)读前 1KB —— 多数文本特征已足够 - 用
mime.TypeByExtension判断扩展名对应 MIME，再按类型分流：文本类（text/）做 UTF-8 解码后关键词扫描；二进制类（application/pdf）可跳过或调外部工具（如pdftotext） - 注意
os.ReadFile可能返回io.ErrUnexpectedEOF（文件被截断）或encoding.UTF8解码失败，需用strings.ToValidUTF8或bytes.ReplaceAll清洗
索引结构选 map[string][]string 还是 SQLite？
小项目（
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 起步阶段用
map[string][]string存 “词 → 路径列表”，词可来自文件名、路径分段、或内容分词（用strings.Fields粗粒度切分） - 超过 5k 文件就该切 SQLite：建表
CREATE TABLE files (path TEXT UNIQUE, mtime INTEGER, size INTEGER)和CREATE TABLE tokens (token TEXT, path TEXT, FOREIGN KEY(path) REFERENCES files(path))，插入用exec批量，查询用LIKE '%word%'或 FTS5（启用全文索引） - SQLite 文件本身要设为
0600权限，避免其他用户读取索引里的敏感路径
搜索时如何避免卡死或返回不相关结果
用户输个 "conf" 就扫出几百个 config.toml、webpack.config.js、configure.ac —— 不是结果多，而是没做权重和过滤。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 路径匹配优先级高于内容匹配：先查
strings.Contains(filepath.Base(path), query)，再查内容；命中路径的条目排前面 - 对内容匹配结果加分数：文件名完全匹配 +3 分，路径包含 +2 分，内容出现 +1 分，最后按分排序
- 用
filepath.Ext提前过滤扩展名（如只搜.go文件），比在内容里硬筛快一个数量级 - 设置超时：用
context.WithTimeout(ctx, 3*time.Second)包裹搜索逻辑，防止大索引下 hang 住
真正麻烦的不是怎么建索引，而是什么时候该丢弃旧索引、怎么检测文件变更后只增量更新——这些得靠 fsnotify 监听 + 时间戳比对，但 watch 本身在 NFS 或容器挂载点上常失效，得 fallback 到定期全量重建。
