索引您的代码库

为了获得更好、更准确的代码库答案，您可以使用@codebase或Ctrl/⌘ Enter索引您的代码库。在后台，Cursor 会计算代码库中每个文件的嵌入，并将使用这些来提高代码库答案的准确性。

您的代码库索引将自动与您的最新代码库更改同步。

您的代码库索引状态如下Cursor Settings> Features> Codebase Indexing。

 

高级设置

默认情况下，Cursor 将索引代码库中的所有文件。

您还可以展开该Show Settings部分以访问更多高级选项。在这里，除了 .gitignore 设置之外，您还可以决定是否要为新存储库启用自动索引，并配置 Cursor 在存储库索引期间将忽略的文件。

如果您的项目中有任何 AI 绝对不需要读取的大型内容文件，那么忽略这些文件可以提高答案的准确性。

要忽略包含在 Cursor 功能（例如代码库索引）中的文件，您可以使用.cursorignore项目根目录中的文件。它的工作方式与.gitignoregit 的工作方式相同。

.cursorignore尊重.gitignore。如果您已经有.gitignore，则默认会忽略这些文件。如果您想忽略其他文件，可以将它们添加到.cursorignore文件中。

示例.cursorignore文件

忽略特定文件

# Ignore all files in the `dist` directory
dist/

# Ignore all `.log` files
*.log

# Ignore specific file `config.json`
config.json


仅包含特定文件

仅包含目录*.py中的文件app。请注意，这与 的语法相同.gitignore。

 
# ignore everything
*
# do not ignore app
!app/
# do not ignore directories inside app
!app/*/
!app/**/*/
# don't ignore python files
!*.py


故障排除

忽略文件语法有时有点令人困惑。该.cursorignore文件遵循与完全相同的语法.gitignore，因此如果您尝试使用忽略文件，但它没有按预期工作，我们建议您使用 Google 搜索该问题，cursorignore在搜索查询中替换为gitignore。可能有人遇到过同样的问题，StackOverflow 会有一个很好的答案。

一个常见的例子：这里是如何忽略除带有.php扩展名的文件之外的所有文件（仅添加*后跟!*.php不起作用，因为 gitignore 文件发现器不会深入并发现.php子目录中的任何文件）。