忽略文件

了解如何使用 .cursorignore 和 .cursorindexingignore 来控制 Cursor 中的文件访问和索引。

概述

Cursor 提供了两种不同的忽略文件来控制文件的处理方式：

.cursorignore：尽最大努力从 AI 功能和索引中排除文件。

.cursorindexingignore：仅控制哪些文件被索引以用于搜索和上下文 (与旧的 .cursorignore 相同)。

从 0.46 版本开始，.cursorignore 尝试从 AI 访问和索引中排除文件 (类似于之前未发布的 .cursorban)。对于像旧的 .cursorignore 一样仅控制索引，请使用 .cursorindexingignore。

`.cursorignore`

.cursorignore 是尽最大努力的，这意味着我们不保证其中的文件会被阻止上传。我们可能有错误允许忽略的文件在某些情况下被上传。如果您发现这样的错误，请告诉我们，我们将尽力修复！

.cursorignore 文件尽最大努力从 AI 功能和索引中排除文件。这对于以下情况很有用：

尝试从 AI 访问和索引中排除敏感文件。

排除包含密钥的配置文件。

限制对专有代码的访问。

.cursorignore 中列出的文件将以尽最大努力的方式从 Cursor 的 AI 功能中排除：

不包含在 Tab 和 Chat 请求中

不包含在 AI 功能的上下文中

不会被索引以用于搜索或上下文功能

无法通过 @ 符号或其他上下文工具访问

`.cursorindexingignore`

.cursorindexingignore 文件自动继承 .gitignore 文件中的所有模式。

.cursorindexingignore 文件仅控制哪些文件被索引以用于搜索和上下文功能。这提供了与旧的 .cursorignore 相同的索引控制。当您想要以下操作时，请使用此文件：

从索引中排除大型生成的文件。

跳过二进制文件的索引。

控制代码库的哪些部分可搜索。

优化索引性能。

重要提示：.cursorindexingignore 中的文件仍然可以手动作为上下文包含或被 AI 功能访问 - 它们只是不会被自动索引或包含在搜索结果中。

默认的索引忽略文件 (Default Indexing Ignore Files)

文件格式

这两个文件使用与 .gitignore 相同的语法。这里有一些例子：

基本模式

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

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

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

高级模式

仅包含 app 目录中的 *.py 文件：

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

问题排查

忽略文件 (ignore file) 的语法与 .gitignore 完全相同。如果您遇到问题：

在搜索查询中将 "cursorignore" 替换为 "gitignore"。

在 Stack Overflow 中查找类似的模式。

使用 git check-ignore -v [file] 测试模式以了解匹配情况。

常见陷阱：

模式相对于忽略文件 (ignore file) 的位置进行匹配。

后面的模式会覆盖前面的模式。

目录模式需要尾部斜杠。

否定模式 (!) 必须否定之前的模式。

忽略文件配置

忽略文件#

概述#

.cursorignore#

.cursorindexingignore#

文件格式#

基本模式#

高级模式#

问题排查#