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

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

示例 .cursorignore 文件

忽略特定文件

  1. # 忽略 `dist` 目录中的所有文件
  2. dist/
  4. # 忽略所有 `.log` 文件
  5. *.log
  7. # 忽略特定文件 `config.json`
  8. config.json

仅包括特定文件

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

  1. # 忽略所有内容
  2. *
  3. # 不忽略 app
  4. !app/
  5. # 不忽略 app 目录中的子目录
  6. !app/*/
  7. !app/**/*/
  8. # 不忽略 Python 文件
  9. !*.py

故障排除

忽略文件的语法有时会让人感到困惑。.cursorignore 文件遵循与 .gitignore 完全相同的语法，因此如果你尝试使用忽略文件但结果与预期不符，我们建议在 Google 上搜索该问题，将查询中的 cursorignore 替换为 gitignore。可能会有人遇到过类似问题，并且 StackOverflow 上会有好的答案。

一个常见示例：这是如何忽略所有文件，除了那些具有 .php 扩展名的文件（仅添加 * 后跟 !*.php 不会奏效，因为 gitignore 文件的发现器不会深入到子目录中查找任何 .php 文件）。