Cursor 官方文档中文版
  1. 上下文管理
Cursor 官方文档中文版
  • 快速入门
    • 简介
    • 安装
    • 常见问题 (FAQ)
  • 使用手册
    • 编辑器迁移
      • 从 VS Code 迁移
      • 从 JetBrains IDE 迁移
    • 支持的语言与框架
      • JavaScript 与 TypeScript
      • iOS 与 macOS(Swift)
      • Java
  • 编辑器
    • AI 生成提交信息
    • 记事本功能(Beta)
    • 键盘快捷键
    • 标签页管理
      • 概述
      • 标签页 vs GitHub Copilot
      • 自动导入依赖
      • 高级功能
    • 智能会话 (Chat)
      • 概述
      • 智能体模式
      • 问答模式
      • 自定义模式
      • 工具集
      • 应用更改
    • ⌘K
      • 概述
      • 终端命令(Cmd+K)
  • 上下文管理
    • 代码库索引
    • AI 行为规则
    • 忽略文件配置
    • 上下文协议 (Model Context Protocol)
    • @ Symbols
      • Overview
      • @Files
      • @Folders
      • @Code
      • @Docs
      • @Git
      • @Web
      • @Definitions
      • @Link
      • @Lint Errors
      • @Recent Changes
      • @Cursor Rules
      • @Notepads
      • @Summarized Composers
      • #Files
      • /command
  • 账户
    • 套餐与用量
    • 数据看板
    • 账单管理
    • 商业版
      • 快速入门
      • 成员与角色管理
      • 数据分析
      • 单点登录(SSO)
  • 设置
    • 模型管理
    • 自定义 API 密钥
    • 早期体验计划
  • 故障排除
    • 常见问题
    • 故障排除指南
    • 获取请求 ID
  1. 上下文管理

代码库索引

了解如何在 Cursor 中索引你的代码库,以获得更准确的 AI 辅助和搜索结果

索引你的代码库#

为了获得更好、更准确的代码库答案,你可以索引你的代码库 (Codebase)。 在后台,Cursor 会为你的代码库中的每个文件计算嵌入 (embeddings),并使用这些嵌入来提高代码库答案的准确性。
当一个项目被打开时,每个 Cursor 实例都会初始化该工作区的索引。 在初始索引设置完成后,Cursor 将自动索引添加到你的工作区中的任何新文件,以保持你的代码库上下文的最新。
你的代码库索引的状态位于“Cursor 设置” > “功能 (Features)” > “代码库索引 (Codebase Indexing)”下。
img

高级设置#

默认情况下,Cursor 将索引你的代码库中的所有文件。
你还可以展开“显示设置 (Show Settings)”部分以访问更多高级选项。 在这里,你可以决定是否要为新的代码仓库启用自动索引,以及配置 Cursor 在代码仓库索引期间将忽略的文件。
Cursor 使用与 VS Code 相同的包来处理文件忽略,这意味着它尊重所有 .gitignore 文件,包括子目录中的文件。 你还可以创建一个 .cursorignore 文件,用于用户特定的忽略模式,你可能希望将其添加到你的全局 .gitignore 文件中,以避免将其提交到代码仓库。
如果你的项目中有任何 AI 绝对不需要读取的大型内容文件,忽略这些文件 可能会提高答案的准确性。

处理大型单体代码仓库#

当处理包含数十万个文件的大型单体代码仓库 (monorepos) 时,重要的是要策略性地决定要索引的内容。
使用 .cursorignore 让每个开发者配置他们在单体代码仓库中使用的文件夹和路径。
将 .cursorignore 添加到你的全局 .gitignore
这允许每个开发者针对他们在单体代码仓库中的特定工作区域优化索引。

FAQ#

在哪里可以看到我已索引的所有代码库?#

目前,无法查看你已索引的所有代码库的列表。 你需要通过在 Cursor 中打开项目并检查“代码库索引 (Codebase Indexing)”设置来手动检查每个项目的索引状态。

如何删除所有代码库?#

你可以从“设置 (Settings)”中删除你的 Cursor 帐户以删除所有索引的代码库,或者从每个项目中的“代码库索引 (Codebase Indexing)”设置中手动删除单个代码库。 目前,没有办法在不删除你的帐户的情况下一次删除所有代码库。
上一页
终端命令(Cmd+K)
下一页
AI 行为规则
Built with