9. 代码库上下文


项目级理解

Cursor 通过自研嵌入模型为整个代码库建立语义索引。这意味着 AI 不仅知道某个文件的内容,还理解文件之间的关系、函数的调用链路、类型的继承关系。

当你提问时,AI 会自动搜索最相关的代码上下文来回答。

文件与目录引用

在 Chat 或 Agent 中使用 @ 精确控制上下文:

@src/models/user.ts @src/services/auth.ts
分析这两个文件之间的耦合度,提出解耦建议
@src/api/
检查这个目录下所有路由的错误处理是否一致

代码片段引用

在编辑器中选中一段代码,然后按 Ctrl/Cmd + L 将其发送到 Chat,AI 会基于选中的代码进行回答。

大型仓库上下文管理

对于超大型仓库,建议:

  • 使用 .cursorignore 排除无关文件(如 node_modules/、生成文件、第三方代码)
  • 在对话中明确指定关注的目录或文件
  • 将大任务拆分为模块级别的小任务
  • 使用 @Codebase 时配合具体的搜索描述

精准上下文控制

方法适用场景
@filename需要 AI 参考特定文件
@folder/需要 AI 理解某个模块
@Codebase需要 AI 搜索全局
选中代码 + Ctrl+L需要 AI 解释或修改特定代码段
.cursorignore全局排除干扰文件