代码库索引

Cursor 如何学习你的代码库以更好地理解它

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

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 命令。

Using PR search

可以这样提问：“其他 PR 里是如何实现这些服务的？”Agent 会自动将相关 PR 引入上下文，并基于你的仓库历史给出完整答案。

常见问题

在哪里能看到所有已索引的代码库？

目前还没有全局列表。请逐个打开项目，在 Cursor 中查看 Codebase Indexing 设置。

怎么删除所有已索引的代码库？

在设置中删除你的 Cursor 账号即可移除所有已索引的代码库。 或者，你也可以在各项目的 Codebase Indexing 设置里逐个删除代码库。

已索引的代码库会保留多久？

已索引的代码库在 6 周无活动后会被删除。重新打开该 项目会触发重新索引。

我的源代码会存储在 Cursor 的服务器上吗？

不会。Cursor 会创建 embeddings，但不会存储文件名或源代码。文件名会被混淆，代码片段会被加密。

当 Agent 搜索代码库时，Cursor 会从服务器检索 embeddings 并解密这些片段。