只需为代码库建立一次索引，让 Cursor Agent 自行解决问题

Cursor 的代码库索引让它的 Agent 模式能够对你整个项目结构产生语义理解，而无需手动切换上下文。索引一次之后，用自然语言描述高层次任务，Agent 便会自主探索文件、进行多文件编辑、运行测试并反复迭代直至完成，将复杂功能的开发时间缩短 50% 至 70%。

Cursor 的独特之处不在于自动补全，而在于代码库索引。与只能看到当前文件的 IDE 插件不同，Cursor 会为整个代码仓库建立语义索引，让 AI 深入理解你的项目结构、模式和依赖关系。这把 Agent 模式从“猜测”转变为“推理”。

克隆代码仓库后应立即设置索引：打开 Cursor，按下 Cmd+Shift+P，搜索“Cursor: Index Codebase”，等待索引构建完成。此过程只执行一次并会持久保留。此后当你向 Agent 模式描述任务时（Cmd+L，然后切换到 Agent），AI 会在进行更改之前先读取索引，理解某一文件中的编辑如何在整个代码库中传播。

一个具体的专业工作流示例：与其手动翻阅文件来重构一个遗留模块，不如写一段范围明确的提示词，例如：“为 POST /api/users 添加一个限流中间件，更新 types 文件夹中的类型定义，并编写 Vitest 测试。”具备代码库上下文的 Agent 模式会探索相关文件、跨多个文件进行更改、运行测试、捕获错误并反复迭代，在 15 至 30 分钟内完成通常需要 2 至 3 小时的工作。当任务较为复杂时，可使用 @codebase 和 @folder 提及，将上下文引导至特定区域。团队反馈称，如果他们尽早建立索引，并用 Agent 模式处理多文件任务而非单文件编辑，开发速度可提升 2 至 3 倍。