Cursor 会为每个文件计算向量嵌入(embedding),从而为你的代码库建立索引,这能让关于你代码的 AI 回答更准确。打开项目后,Cursor 会自动开始索引;新文件会按需增量索引。 在这里查看索引状态:Cursor Settings > Indexing & Docs
代码库索引进度指示器

配置

Cursor 会索引除忽略文件(如 .gitignore.cursorignore)中列出的文件外的所有文件。 点击 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 拉取到上下文中,并基于你的仓库历史提供全面的答案。

常见问题

目前还没有全局列表。请逐个在 Cursor 中打开项目, 然后查看 Codebase Indexing 设置。
在 Settings 中删除你的 Cursor 账户即可移除所有已索引的代码库。 否则,请在各项目的 Codebase Indexing 设置中分别删除对应的代码库。
已索引的代码库在 6 周无活动后会被删除。重新打开 项目会触发重新索引。
不会。Cursor 会创建向量嵌入(embeddings),但不会存储文件名或源代码。文件名会被混淆,代码片段会被加密。当 Agent 搜索代码库时,Cursor 会从服务器检索嵌入并解密这些片段。