当你需要让 AI 理解的不只是当前打开的文件，而是整个项目的结构、依赖关系和跨文件逻辑时，使用 @Codebase（中文界面下显示为 @代码库）。
使用方式
在侧边栏 Chat 或 Agent 模式的输入框中，输入 @，选择 Codebase / 代码库，然后直接描述你的需求。例如：
@Codebase 这个项目的用户认证中间件在哪几个路由文件里被引用了？
@Codebase 把 utils/formatDate.js 里的逻辑统一换成 dayjs，并列出所有需要同步修改的文件Cursor 会做什么
首次在项目内使用该指令时，Cursor 会在后台对本地代码库进行轻量级索引（建立语义检索库，通常排除 node_modules、dist、.git 等目录）。绑定 @Codebase 后，AI 在回答前会自动检索项目中相关的文件、函数定义和调用链，相当于把"整个代码库"作为动态上下文一并提交给模型。
典型适用场景
- 陌生项目上手：刚接手遗留代码时，快速了解技术栈、目录规范或核心模块划分；
- 跨文件联查：追踪某个函数、类型或配置项在全库中的定义位置与引用路径；
- 批量重构落地：要求 AI 修改公共工具函数并同步更新所有引用文件，AI 能基于全库上下文给出具体的改动范围。
注意事项
- 首次索引：大型仓库首次建立索引可能需要数十秒，期间可正常编码，索引完成后后续提问会更快。
- 隐私与范围：索引过程主要在本地完成，不会上传完整源码。如果项目包含大量非代码文件，可在 Cursor Settings → Features → Codebase Indexing 中自定义忽略规则，减少干扰并提升检索精准度。
- 问题越具体，效果越好：
@Codebase适合有明确目标的查询。如果提问过于宽泛（如"优化整个项目"），AI 可能因上下文过载而给出泛泛建议，建议配合模块名或关键词缩小范围。