必须打开项目根目录并执行Re-index Project才能让Cursor AI理解全项目结构。需通过Open Folder选择含元数据的最外层文件夹，等待索引完成；手动触发Re-index确保符号表准确；配置.cursorignore或设置忽略路径；monorepo需添加多根工作区并重新索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让Cursor AI真正理解整个项目结构、函数调用链和模块依赖关系，而不是只盯着当前打开的单个文件胡乱猜测，必须激活并正确配置其代码库索引能力——这一步不做，AI就永远是“只见树木不见森林”的局部观察者。
确认项目根目录已正确加载
Cursor AI 的索引逻辑严格绑定于工作区根路径。若你只是双击打开了 src/main.ts，或通过“Open File”打开单个文件，AI 将完全看不到 package.json、tsconfig.json、.git 或任何子目录，自然无法建立跨文件关联。
关闭所有已打开的文件和文件夹 → 点击菜单栏 File → Open Folder → 选择包含 .git 目录或 package.json/pyproject.toml/Cargo.toml 等项目元数据文件的最外层文件夹 → 等待右下角状态栏从 “Indexing project…” 变为 “Ready”。
这一步不可跳过。没有这个根目录，后续所有索引操作都像在空地上盖楼——地基根本不存在。
手动触发全项目语义索引
默认后台索引可能因项目体积大、文件系统延迟或.gitignore规则冲突而漏掉关键路径。此时必须强制重建符号表，让 AI 重新扫描所有可读源码并建立函数定义→引用的双向映射。
按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS） 打开命令面板 → 输入 Cursor: Re-index Project 并回车 → 观察底部终端是否输出 Building symbol table for N files… 及最终完成提示。
索引完成后，在任意 .ts 文件中输入 “main.ts 调用了哪些 services 下的函数？”，AI 若能准确列出 UserService.fetchUser、AuthClient.refreshToken 等真实调用，说明跨文件理解已生效。
配置 .cursorignore 精简上下文源
方法一：在项目根目录新建纯文本文件，命名为 .cursorignore，内容逐行写入需排除的路径模式：
node_modules/
dist/
build/
*.log
.env*
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
保存后执行 Cursor: Re-index Project，确保新规则立即生效。
方法二：直接在 Cursor 设置中操作 —— 打开 Settings (Ctrl+,) → Features → Codebase Indexing → Ignore Patterns，在输入框中粘贴上述路径，每行一个。
注意：.cursorignore 语法与 .gitignore 完全一致，但不继承 .gitignore 内容；必须显式声明，否则 node_modules 里的类型声明会污染索引权重，导致 AI 在 import 时优先推荐错误路径。
启用多根工作区支持 monorepo
对于含多个子包的单体仓库（如 packages/api、packages/web、packages/cli），单一根目录会导致跨包引用不可见。例如 web 包里调用 api 包的接口，AI 若只索引 web 目录，就完全不知道那个函数存在。
第一步：点击菜单栏 File → Add Folder to Workspace → 分别添加每个子项目根目录（如 packages/api、packages/web）；
第二步：保存工作区为 .code-workspace 文件（如 my-monorepo.code-workspace）；
第三步：重启 Cursor 并打开该 .code-workspace 文件 → 确认状态栏显示 Multi-root workspace → 执行 Cursor: Re-index Project。
此时 AI 在 packages/web 中提问 “调用 packages/api/src/db/connect.ts 的 connectDB 方法时，参数类型是什么？”，将能精准解析并返回 interface ConnectOptions { host: string; port?: number }。
