Appearance
Kiro 编辑器会自动索引你的代码库和文档，这是代码智能补全、跨文件跳转和上下文感知建议的基础。索引在打开项目时自动触发，文件新增或外部变更时自动更新。当索引出现问题时，可通过命令面板手动触发强制重建。理解索引机制有助于在大型代码库中获得更稳定的 AI 辅助体验。
索引何时发生
自动索引
Kiro 在以下情况自动执行索引：
- 项目导入时：首次在 Kiro 中打开项目，自动开始索引工作区所有文件
- 文件变更时：项目中新建或新增文件时，自动索引
- 外部变更时：通过 Kiro 之外的方式修改文件（如 git 操作）时，自动重新索引
手动触发索引
需要时可通过命令面板手动触发索引：
- macOS：
Cmd+Shift+P - Windows/Linux：
Ctrl+Shift+P
可用的索引命令
通过命令面板可以访问以下索引管理命令：
代码库索引
Kiro: Codebase Force Re-Index（强制重新索引）：强制对整个代码库完整重新索引。适合以下情况：- 怀疑索引损坏或不完整
- 对项目进行了大规模结构变更
- Kiro 的代码建议看起来过时
Kiro: Rebuild codebase index（重建代码库索引）：从头完整重建代码库索引，比强制重新索引更彻底。适合以下情况：- 索引严重损坏
- 持续遇到代码导航或建议异常的问题
文档索引
Kiro: Docs Index：开始索引项目中的文档文件Kiro: Docs Force Re-Index：强制对所有文档文件完整重新索引
监控索引进度
通过 Kiro 日志面板可以监控索引过程：
- 打开 Kiro 的 Output（输出）面板
- 从下拉菜单中选择 "Kiro Logs"
- 查看实时索引进度和状态更新
日志内容包括：
- 索引开始和完成的时间
- 发现和处理的文件数量
- 大型代码库的进度百分比
- 索引操作的完成耗时
被索引的内容
Kiro 会索引多种类型的内容以提供智能辅助：
- 源代码：工作区中所有编程语言文件
- 文档：Markdown、MDX 及其他文档格式
- 配置：项目配置文件和清单文件
- 依赖：包定义和依赖信息
索引数据支撑以下功能：
- 智能代码补全
- 跨文件导航
- 上下文感知建议
- 文档查找
- 代码重构辅助
常见问题
Q：项目很大，索引需要很长时间，有办法加快吗？
A：Kiro 的索引是增量的——首次完整索引耗时最长，之后只对变更的文件做增量更新。如果项目确实很大，可以通过 .gitignore 或项目配置排除不需要索引的目录（如 node_modules、构建产物等），减少索引范围。
Q：什么时候应该用"Force Re-Index"而不是"Rebuild"？
A：两者的区别在于彻底程度。Force Re-Index 是重新处理所有文件但保留已有的索引数据库结构，速度相对更快；Rebuild 是完全从零重建，包括清除旧的索引数据，耗时更长但更彻底。建议先用 Force Re-Index，如果问题仍然存在再考虑完整 Rebuild。
Q：通过 git 切换分支后，索引会自动更新吗？
A：是的。Kiro 会检测外部文件变更（包括 git 操作引起的变更）并自动重新索引受影响的文件，无需手动干预。如果切换到差异很大的分支后建议看起来不准确，可以用 Force Re-Index 手动触发完整更新。