Cursor 会为每个文件计算向量嵌入来为你的代码库建立索引。这能提升与代码相关的 AI 回答质量。打开项目时,Cursor 会自动开始索引。新文件会被增量索引。 在这里查看索引状态:Cursor Settings > Indexing & Docs
代码库索引进度指示器

配置

除了忽略文件(如 .gitignore.cursorignore)中列出的那些,Cursor 会索引所有文件。 点击 Show Settings 可:
  • 为新仓库启用自动索引
  • 配置需要忽略的文件
忽略大型内容文件有助于提升回答的准确性。

查看已索引的文件

查看已索引的文件路径:Cursor Settings > Indexing & Docs > View included files 这会打开一个 .txt 文件,列出所有已索引的文件。

多根工作区

Cursor 支持多根工作区,让你可以同时处理多个代码库:
  • 所有代码库都会被自动索引
  • 每个代码库的上下文都可供 AI 使用
  • .cursor/rules 在所有文件夹中都生效
PR search 通过让历史变更可被 AI 检索与访问,帮助你理解代码库的演进。

How it works

Cursor 会自动索引仓库历史中所有已合并的 PR。摘要会出现在语义搜索结果中,并提供智能过滤以优先展示最新变更。 Agent 可以使用 @[PR number]@[commit hash]@[branch name]PR、commit、issue 或分支引入上下文。连接后会包含 GitHub 评论和 Bugbot 评审。 平台支持包括 GitHub、GitHub Enterprise 和 Bitbucket。目前不支持 GitLab。
GitHub Enterprise 用户:由于 VSCode 认证限制,fetch 工具会回退到 git 命令。
可以这样提问:“其他 PR 里是如何实现这些服务的?”Agent 会自动将相关 PR 引入上下文,并基于你的仓库历史给出完整答案。

常见问题