​
概览

Cursor 会读取并索引你项目的代码库，以驱动其功能。使用根目录中的 .cursorignore 文件控制 Cursor 可访问的目录和文件。 Cursor 会将 .cursorignore 中列出的文件从以下范围排除：
由 Agent 发起的工具调用（如终端和 MCP 服务器）无法阻止 访问受 .cursorignore 管控的代码

​
为什么要忽略文件？

安全：限制对 API 密钥、凭证和机密的访问。虽然 Cursor 会阻止访问被忽略的文件，但由于 LLM 的不可预测性，无法做到绝对防护。 性能：在大型代码库或 monorepo 中，排除无关部分，以更快完成索引并更准确地发现文件。

​
全局忽略文件

在用户设置中为所有项目配置忽略规则，统一排除敏感文件，无需逐个项目单独设置。
Global Cursor Ignore List
默认规则包括：
  • 环境文件：**/.env、**/.env.*
  • 凭据：**/credentials.json、**/secrets.json
  • 密钥：**/*.key、**/*.pem、**/id_rsa

​
配置 .cursorignore

在项目根目录创建 .cursorignore 文件，语法与 .gitignore 相同。

​
模式示例

config.json      # 指定文件
dist/            # 目录
*.log            # 文件扩展名
**/logs          # 嵌套目录
!app/            # 取消忽略（取反）

​
分层忽略

开启 Cursor Settings > Features > Editor > Hierarchical Cursor Ignore，在父级目录中查找 .cursorignore 文件。 注意：注释以 # 开头。后出现的模式会覆盖先出现的模式。模式相对于文件所在位置进行匹配。

​
使用 .cursorindexingignore 限制索引

使用 .cursorindexingignore 可仅将文件排除在索引之外。这些文件依然可被 AI 功能访问，但不会出现在代码库搜索结果中。

​
默认情况下忽略的文件

Cursor 会自动忽略 .gitignore 中的文件以及下方的默认忽略列表。可以在 .cursorignore 中用 ! 前缀进行覆盖。

​
取反模式的限制

使用取反模式（以 ! 开头）时，如果父级目录通过 * 被排除，则无法重新包含该文件。 
# 忽略 public 文件夹中的所有文件
public/*

# ✅ 可行，因为该文件位于顶层
!public/index.html

# ❌ 不可行——无法从嵌套目录中重新包含文件
!public/assets/style.css
解决方案：显式排除嵌套目录： 
public/assets/*
!public/assets/style.css # 现在该文件可被访问
出于性能考虑，被排除的目录不会被遍历，因此对其中文件的匹配模式不会生效。 这与 .gitignore 在嵌套目录中的取反模式实现一致。更多详情请参考Git 官方关于 gitignore 模式的文档。

​
疑难排查

用 git check-ignore -v [file] 来测试匹配规则。