Cursor 为什么老说“没找到项目里的代码”?很多时候不是模型突然变笨了,而是你的代码根本没被它索引进去。Cursor 官方在 Codebase Indexing 和 Ignore files 里都写得很明白:Cursor 会自动索引代码库,但会跳过 `.gitignore`、`.cursorignore` 以及额外忽略规则里的内容。
最常见的误区
很多人以为“我本地能看到这个文件,Cursor 就一定能看到”。其实不是。只要这个目录被忽略了,Tab、Agent、Inline Edit,甚至 @ 引用都可能拿不到它。大型仓库、monorepo、前端构建目录里,这种情况尤其多。
官方建议先查哪里
- 去 Cursor Settings > Indexing & Docs 看索引状态。
- 点 View included files,直接看它到底把哪些文件算进去了。
- 检查 `.cursorignore`、`.gitignore` 和额外 ignore 规则。
如果你发现它总是答非所问,别急着换模型,先确认它有没有看见正确的文件。很多所谓“Cursor 搜不到代码”,最后都是索引范围配置得太狠,或者忽略规则把关键目录一起挡掉了。