Cursor 会为代码库建立索引,但索引范围仍受忽略规则和项目内容影响。能检查索引状态、排除不该进入上下文的路径,并用可核对的问题验证索引是否可用本文给出的是可复现流程,所有界面和服务可用性以核验日期的官方文档为准。
开始前:先定义完成标准
适合人群:刚把现有项目交给 Cursor、需要控制 AI 可见范围的开发者。

第一步先打开项目设置中的 Indexing & Docs,记录已索引文件数量和当前状态。
- 先保存或提交现有改动,保证可以回退。
- 示例不含真实密钥、客户数据和生产地址。
- 把测试命令和预期结果写在生成代码之前。
按步骤完成任务
1. 先画出项目边界
列出源码目录、测试目录、生成目录和可能含密钥的文件。示例项目可把 src/ 与 tests/ 纳入检查,把 dist/、coverage/、.env 与本地数据库排除。不要先问 AI,再凭回答猜它看到了哪些文件。
2. 检查索引状态
打开 Cursor 设置中的 Indexing & Docs。等待状态完成后记录文件数量;如果数量明显少于源码文件,先检查忽略规则,如果明显过多,则检查构建产物和依赖目录是否被纳入。
3. 写最小忽略规则
在项目根目录维护 .cursorignore,并沿用 .gitignore 中对依赖和构建产物的排除思路。例如排除 .env、dist/、coverage/ 和 *.sqlite。规则改动后重新查看索引状态。
4. 做可证伪的问题
不要只问“介绍项目”。改问“src/auth/session.py 中 refresh_session 返回哪些状态?请列出路径和函数名”。然后亲自打开该文件逐项核对。引用了错误路径,说明回答不能直接使用。
.cursorignore 示例(请按真实项目调整)
.env
dist/
coverage/
*.sqlite
把示例中的路径、字段和命令替换为自己的真实项目值。示例只用于说明方法,不冒充真实项目执行结果。
怎样验证结果
验证时询问一个只能从指定文件得出的事实,并要求回答同时给出文件路径。
- 先核对工具实际修改的文件和配置,不依据聊天摘要判断。
- 运行预先约定的最小验证,再检查一个失败或边界输入。
- 记录命令、环境、退出状态和仍未覆盖的风险;验证失败就回到具体差异修正。
失败处理与适用边界
索引可用不等于回答一定正确;生成目录、密钥文件和未保存内容也不应靠索引机制代替权限管理。
遇到错误时保留完整报错、工具版本、操作系统和最小复现输入。一次只修改一个变量;无法获得必要权限、依赖或官方信息时停止,不让 AI 猜测成功结果。
官方资料
相关问答
AI 说已经完成,是否可以直接提交?
不可以。至少要查看实际差异并运行约定的验证;涉及权限、依赖或数据的改动还要由对应负责人审查。
无法运行完整测试怎么办?
如实记录缺少的环境或权限,先运行可用的最小检查,并把状态保留为未完全验证,不把推测写成已通过。
Ai菜鸟网。发布者:AI小管家,转载请注明出处:https://www.alyyhw.com/31098.html