忽略文件与访问边界
使用 .cursorignore 与 .gitignore 排除 AI 文件上下文，并识别终端和 MCP 的独立访问。
This page has not been translated into English yet. The original Chinese version is shown below.
在项目根目录创建 .cursorignore，列出不适合直接加入 AI 上下文的文件与目录，例如生成产物和凭据文件。
node_modules/
dist/
*.min.js
.env*这是示例列表，应按项目调整。Cursor 也自动遵循 .gitignore，并默认忽略 .env、.git/ 和 lock files；完整默认列表以官方 Ignore files reference 为准。
两份文件的用途
.gitignore 已覆盖的文件会从 AI 上下文排除；.cursorignore 用于附加排除，无需为了控制 Cursor 而改变 Git 跟踪策略。生成文件、二进制和第三方代码通常会制造噪声，排除它们有助于聚焦项目本身。
不等于所有工具禁止读取
忽略文件会被 Agent 的文件访问控制阻止，但 terminal commands 和 MCP tools 在这层控制之外运行，仍可能读到这些文件。需要强制秘密访问边界时，应同时配置运行权限与沙箱，不能仅依赖 ignore 文件。
文件找不到时
先确认文件路径与工作区根，再检查 .gitignore 和 .cursorignore 是否匹配。若有意排除，不应为了让 Agent 看见就把整个敏感目录重新开放；可以提供脱敏片段或更窄的必要上下文。