.cursorignore 文件

.cursorignore 文件

.cursorignore 文件可让你从 Cursor 的代码库索引中排除文件和目录

关于 .cursorignore

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

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

Chat 和 Composer Context

目前，无论设置如何，Cursor Chat 和 Composer 都可以访问其上下文中的所有文件.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子目录中的任何文件）。