忽略文件

要在 Cursor 功能(如代码库索引)中忽略某些文件，你可以在项目根目录中使用 .cursorignore 文件。它的工作方式与 git 的 .gitignore 完全相同。

.cursorignore 会遵循 .gitignore 的设置。如果你已经有 .gitignore 文件，这些文件默认就会被忽略。如果你想忽略额外的文件，可以将它们添加到 .cursorignore 文件中。

示例 .cursorignore 文件

忽略特定文件

# 忽略 `dist` 目录中的所有文件
dist/

# 忽略所有 `.log` 文件
*.log

# 忽略特定文件 `config.json`
config.json

仅包含特定文件

以下示例仅包含 app 目录中的 *.py 文件。注意这与 .gitignore 使用相同的语法。

# 忽略所有文件
*
# 不忽略 app 目录
!app/
# 不忽略 app 内的目录
!app/*/
!app/**/*/
# 不忽略 python 文件
!*.py

故障排除

ignore 文件的语法有时会让人感到困惑。.cursorignore 文件遵循与 .gitignore 完全相同的语法，所以如果你尝试使用 ignore 文件但它没有按预期工作，我们建议你在 Google 上搜索这个问题，将搜索查询中的 cursorignore 替换为 gitignore。很可能有人遇到过相同的问题，并且在 StackOverflow 上有很好的解答。

一个常见的例子：如果你想忽略除了 .php 扩展名以外的所有文件（仅添加 * 后跟 !*.php 是不够的，因为 gitignore 文件发现器不会深入到子目录中去发现 .php 文件）。