概览
.cursorignore
文件控制 Cursor 能访问哪些目录和文件。
.cursorignore
中列出的文件会被排除在以下范围之外:
- 代码库索引
- Tab、Agent 和 Inline Edit 可访问的代码
- 通过 @ 符号引用 可访问的代码
由 Agent 发起的工具调用(比如 terminal 和 MCP servers)无法阻止
访问受
.cursorignore
约束的代码为什么要忽略文件?
全局忽略文件

- 环境文件:
**/.env
、**/.env.*
- 凭据:
**/credentials.json
、**/secrets.json
- 密钥:
**/*.key
、**/*.pem
、**/id_rsa
配置 .cursorignore
.gitignore
语法的 .cursorignore
文件。
模式示例
分层忽略
Cursor Settings
> Features
> Editor
> Hierarchical Cursor Ignore
,即可在父级目录中搜索 .cursorignore
文件。
注意:注释以 #
开头。后面的模式会覆盖前面的模式。模式以文件所在位置为相对路径。
使用 .cursorindexingignore
限制索引
.cursorindexingignore
将文件仅排除在索引之外。这些文件仍可被 AI 功能使用,但不会出现在代码库搜索结果中。
默认忽略的文件
.gitignore
中的文件以及下方的默认忽略列表。可以在 .cursorignore
中用 !
前缀进行覆盖。
默认忽略列表
默认忽略列表
仅用于索引时,除
.gitignore
、.cursorignore
和 .cursorindexingignore
中指定的文件外,还会忽略以下文件:取反模式的限制
!
开头)时,如果父目录通过 *
被排除,就无法重新包含某个文件。
故障排查
git check-ignore -v [file]
来测试匹配模式。