要让Cursor AI真正读懂GitHub项目，必须触发@Codebase全量索引、将项目根目录设为含.git或配置文件的最外层目录、配置.cursorignore排除node_modules等干扰路径，并用@README.md增强宏观理解。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让Cursor AI真正读懂你打开的GitHub项目代码，不是简单点开文件夹就完事——它必须构建语义索引、排除干扰路径、锚定关键文档，否则AI只会“看得到但读不懂”，提问时答非所问或漏掉核心模块。
确认项目根目录已正确加载
Cursor AI依赖.git目录、package.json、pyproject.toml等元数据识别项目边界。若你在子目录里打开项目，AI将无法感知整体结构和依赖关系，所有跨文件推理都会失效。
关闭当前所有文件和文件夹→点击菜单栏File → Open Folder→选择包含.git或典型配置文件（如Cargo.toml、requirements.txt）的最外层文件夹→等待右下角状态栏从Indexing project变为Ready。
【必须是项目最外层根目录，不能是src/或app/这类子目录】
触发全量代码库索引
默认后台索引可能跳过部分路径，尤其在大型仓库或网络文件系统上。不手动触发，AI永远只能访问局部缓存片段。
方法一：在聊天输入框中直接输入@Codebase并回车→等待右下角提示Codebase indexing started→状态栏显示Indexing complete后停止。
方法二：快捷键Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→输入Cursor: Re-index Project→回车→观察终端输出是否出现Building symbol table for N files及后续完成日志。
索引完成后，在任意文件中按Ctrl+L唤出AI对话框，提问“main.py里init_db()函数被哪些文件调用？”——若能准确列出test_db.py、api/router.py等路径，说明索引成功。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
配置.cursorignore排除噪声文件
node_modules、dist、build、__pycache__这些目录体积大、无业务逻辑，不忽略它们会导致索引变慢3倍以上，且AI注意力被稀释，关键代码权重下降。
第一步：在项目根目录新建纯文本文件，命名为.cursorignore。
第二步：逐行填入需排除的路径模式，例如：
node_modules/
dist/
build/
*.log
__pycache__/
第三步：保存文件→重启Cursor编辑器→再次执行@Codebase→检查右下角Active context sources列表，确认node_modules等路径不再出现。
注意：.cursorignore必须放在根目录，放错位置（比如放进src/里）完全无效。
用@README.md启动宏观理解
README.md是作者写的项目说明书，含目标定位、架构简述与启动流程。不结合它提问，AI容易陷入函数细节而丢失主干逻辑。
确保项目根目录存在README.md→在聊天框中连续输入@Codebase @README.md→紧接着提出自然语言问题，例如：“这个项目的核心功能模块有哪些？每个模块对应的主入口文件是哪个？”
响应中应明确列出如src/core/、app/main.py等路径，并与你本地目录结构一致——若返回路径不存在或命名混乱，说明README未被有效解析，需检查文件编码是否为UTF-8且无BOM头。
