工作区索引

工作区索引帮助 Qoder CN 从本地工作区检索相关代码。代码搜索结果过旧、找不到刚修改的文件，或需要确认是否可以自动更新时，可进入设置检查索引。 索引用于提高跨代码库检索的相关性，不能替代打开并核对本次修改依赖的源文件。将生成产物、依赖目录、日志和本地敏感文件排除在索引外，可以让检索结果更聚焦于需要维护的项目内容。

​

检查工作区

1. 打开用户菜单并选择设置，或使用设置快捷键。
2. 在编码下选择工作区索引。
3. 选择要检查的工作区。
4. 查看索引状态。

状态为未索引时，选择开始索引。开启自动索引后，Qoder CN 会自动为文件数少于 10,000 的代码库创建并更新索引。 在索引排除中选择管理可编辑工作区根目录下的 .qoderignore。其匹配规则与 .gitignore 一致，并且 .gitignore 中列出的内容默认也会被排除。

​

排除不需要索引的文件

在 .qoderignore 中每行写一个匹配规则： 编辑完成后点击保存。不要仅为缩短索引时间而排除仍需要 Agent 查找的源代码目录；被排除的内容无法通过工作区索引检索。

​

确认结果

更新后，返回同一工作区中的任务，让 Qoder CN 查找一个已知符号或刚修改的文件。确认结果引用了预期文件，不要只依据设置页中的状态判断索引可用。

​

排查索引问题

索引没有按预期更新时，先确认工作区路径仍可访问，再检查 .gitignore 和 .qoderignore 是否排除了目标文件。返回设置 → 工作区索引并重新选择该工作区检查状态。文件数量达到 10,000 或更多的代码库不会由自动索引自动创建索引，请手动选择开始索引。