# Cursor七道暗门：补全只是它的零头
**导语**：大多数人把 Cursor 当成「会聊天的 VSCode」——Tab 补全、Ctrl+K 改段代码，就以为用完了。但翻一下 Cursor 官方文档（cursor.com/docs）会发现，编辑器里躺着一批存在超过一年的开关：给它立团队宪法的规则系统、让它现查官方文档的 @docs、挡住 .env 进上下文的 .cursorignore、一键回滚的 Checkpoint……这些功能讨论度远低于模型本身，却是「同一模型、两个段位」的分水岭。这篇把七道暗门一次拆开，每道都给具体操作路径，今晚就能用上。
---
## 为什么补全只是零头
Cursor 的输出质量 = 模型能力 × 喂进去的上下文质量。模型能力你控制不了（大家用的都是那几家），上下文工程才是普通用户和高手之间真正拉开差距的地方。下面七道暗门，本质上全是围绕「让 Agent 在正确的时机、看到正确的材料、做有限的动作」设计的。
## 暗门一：`.cursor/rules`——给 Agent 立一部团队宪法
90% 的人还在干两件蠢事：要么每次对话手动粘贴代码规范，要么根本不写规范、让模型每次自由发挥。
正确做法是在仓库根目录建 `.cursor/rules/` 目录，规则拆成 `.mdc` 文件，支持 frontmatter 控制生效范围：
```markdown
---
description: API 接口统一规范
globs: src/api/**/*.ts
alwaysApply: false
---
- 所有接口返回统一包装 { code, data, message }
- 错误码沿用 errno.ts 中的枚举，禁止新造数字
- 分页参数固定为 page / pageSize
```
三个关键点：
1. **globs 自动挂载**：只有改到 `src/api/**` 下的文件时，这条规则才会进上下文——不用每轮对话白耗 token。
2. **规则里可以 @ 引用文件**：写 `错误码见 @src/constants/errno.ts`，Agent 会自己去读。
3. **让 Agent 自己写规则**：对话里让它总结当前代码库的约定并生成一份规则文件（官方文档中有对应的生成规则入口），你只需要人工过一遍再入库。
国内同类产品（如 Trae、通义灵码）近一两年也补上了类似「项目规则/知识库」机制，但规则按 glob 精准挂载 + 规则内引用文件这套颗粒度，Cursor 仍是打磨最久的。
**适用场景**：多人协作仓库、老项目迁移、外包团队交付——把「口口相传的潜规则」变成机器强制执行。
## 暗门二：`@docs` + `@web`——让模型现查资料，别靠它编
模型对老版本框架 API 信口开河，是所有人的痛。Cursor 里有个被严重低估的功能：**自定义文档库**。
操作路径：对话里输入 `@Docs` → Add new doc → 粘贴文档 URL（可选是否爬取子页面）→ 索引完成后，以后 `@你的文档名` 即可让回答锚定在这份文档上。
- 公司内部框架、私有 SDK 没有公开文档？把内部文档站 URL 丢进去，或者直接把关键 md 文件用 `@Files` 喂给它。
- 问「这个库最新版本怎么用」时，在 Agent 模式下用 `@Web` 强制它联网现查，而不是凭训练记忆输出——2025 年以来这条命令已经能稳定触发联网检索。
- 版本敏感的问题（比如从 Vue2 升 Vue3 的写法差异），先 @ 对应版本文档再提问，幻觉率肉眼可见地下降。
一句话总结：**把「我记得」变成「我查过」，是普通用户转向高手的第一步。**
## 暗门三：`.cursorignore`——上下文防火墙
这是安全 + 省钱双功能，却几乎没人在中文社区聊。
`.cursorignore` 语法和 `.gitignore` 完全一致，写进去的文件**不进索引、不进上下文、不发给云端模型**：
```
.env
**/secrets/
dist/
packages/legacy-monolith/
*.min.js
```
两个直接收益：
1. **安全**：`.env` 里的数据库密码、第三方 API Key 不会再作为上下文片段泄漏出去。做等保或有合规要求的团队，这一行配置比口头叮嘱有用得多。
2. **省 token + 提准确率**：大仓库（monorepo）里你只改前端，就把后端整个目录 ignore 掉。上下文干净了，Agent 找错文件、改错地方的概率同步下降——上下文不是越多越好，是越相关越好。
## 暗门四：Checkpoint——Agent 改崩了，一键回到案发现场之前
2025 年夏天这个功能上线后，「Agent 把我代码改炸了」的惨案少了一大半。
机制：Agent 每做一轮改动，Cursor 自动创建一个工作区快照；聊天记录里每条 Agent 消息旁有「Restore checkpoint」按钮，点了直接把工作区文件恢复到这轮改动之前，**不依赖你有没有及时 git commit**。
注意两点：
- 它是**编辑器内回滚**，不是 git 操作，不会动你的分支历史；两者配合用——先回滚快照，再决定要不要用 git 做更细的取舍。
- 回滚只覆盖 Agent 产生的那段改动，你手动编辑的内容不受影响（以实际版本行为为准，重要改动前先 commit 仍是铁律）。
适用场景：让 Agent 大胆试错。反正有快照兜底，你只需看最终结果，不用在中间步步惊心。
## 暗门五：Notepads——把高频素材变成随手可引用的「贴纸」
Prompt、接口样例、建表语句、代码风格说明……这些每次都要粘贴的东西，应该进 Notepads。
操作：聊天面板里找到 Notepads 区块（便签图标）→ 新建 → 命名为「接口标准」之类 → 以后在任何对话里 `@接口标准` 引用。
它和规则（rules）的区别：**规则是自动注入的「法律」，Notepad 是按需引用的「参考资料」**。一段只和某些任务相关的长样例，放 Notepad 比放规则更省上下文。老版本里的全局 prompt 聊天框基本可以被它替代。
## 暗门六：终端 auto-run 白名单——全自动和手动的正确边界
很多人开 Agent 模式后被烦死：每跑一条 `npm test` 都要点一次确认。另一批人则反过来，全面放开权限，直到某天它执行了 `rm -rf`。
正确姿势在设置里：**Cursor Settings → Agent → Auto-run**，配置命令白名单和黑名单（支持通配符）：
- Allowlist：`npm run *`、`npx vitest *`、`git status`、`git diff`——这些放行，Agent 自动跑，测试-修错循环不再需要人肉点确认。
- Denylist：`rm -rf`、`git push --force`、`drop table`——这些永远停下来等人批准。
这一道配置直接决定你的 Agent 是「全自动流水线」还是「人工收费站」。测试驱动型的开发流程，配好之后 Agent 修 bug 的速度大致能追上它写 bug 的速度。
## 暗门七：MCP——把公司内网工具接进 Cursor
Cursor 原生支持 MCP（Model Context Protocol），仓库级配置只要一个 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres",
"postgresql://localhost:5432/dev"]
}
}
}
```
配好之后，对话里就能让 Agent 直接查开发库表结构、对着真实 schema 写迁移脚本，而不是对着你贴的截图猜字段。国内团队自建的工单系统、CI 状态、内部 API，社区都有现成 MCP server 或可以照协议包一层——这是把 Cursor 从「代码工具」升级成「研发中台入口」的那一步。
**彩蛋：`@Git`**。对话里输入 `@Git` 可以直接引用某个 commit、分支差异或 PR diff。发版前让它「总结本周提交、写 release note」「检查这次改动有没有动到鉴权逻辑」，比人翻 diff 快一个量级。
## 一张图看懂七道暗门怎么协同
```mermaid
flowchart TD
A["你发出一句需求"] --> B["规则层
.cursor/rules 按文件自动注入"]
B --> C["闸门层
.cursorignore 先过滤"]
C -->|白名单文件| D["引用层
@docs @git @Notepad"]
C -->|命中忽略规则| E["密钥与无关文件
永不进入上下文"]
D --> F["模型层
生成改动与命令"]
F --> G{"终端闸门"}
G -->|命令在白名单| H["自动执行
跑测试起服务"]
G -->|命令危险或陌生| I["暂停等你批准"]
F --> J["Checkpoint 快照"]
J --> K["不满意
一键回到改动前"]
```
## 信息差总结
| 你以为的 Cursor | 高手在用的 Cursor |
|---|---|
| 一个补全器，Pro 买亏了 | 补全只是 Tab 层，价值大头在 Agent + 上下文工程 |
| 规范要每次手动贴 | `.cursor/rules` 按 glob 自动挂载，一次写入长期生效 |
| 模型瞎编 API 只能忍 | `@Docs` 自建文档库 + `@Web` 联网现查 |
| `.env` 提心吊胆怕泄漏 | `.cursorignore` 一行挡住，顺带大仓库提效 |
| Agent 改崩只能翻 reflog | Checkpoint 自动快照，一键回滚 |
| 高频素材反复复制粘贴 | Notepads 存好，`@` 一下就引用 |
| 跑命令要么步步确认要么裸奔 | 白名单自动跑，黑名单强制人审 |
| 内网数据接不进来 | `.cursor/mcp.json` 几行接上私有工具 |
**价格参考**：本文写作时公开口径为 Pro 每月 20 美元、Ultra 每月 200 美元，超额部分随用量计费且规则一直在调整，下单前以 cursor.com/pricing 实时页面为准。免费版也能用上面大部分暗门（规则、.cursorignore、Notepads），足够先验证再决定要不要付费。
## 行动指南
今晚回到工位，按顺序做五件事：
1. 建仓库规则：`.cursor/rules/api.mdc`，把你团队接口规范抄成模板（见暗门一代码块），十分钟搞定。
2. 写上下文防火墙：把 `.env`、构建产物、陈年遗留目录全部写进 `.cursorignore`。
3. 挂文档库：把你最常用框架的官方文档 URL 加进 `@Docs`，从今天起提问先 @ 文档。
4. 存一个 Notepad：名字叫「标准请求响应样例」，粘上你们项目的样板代码。
5. 配终端白名单：Allowlist 加 `npm run *` 和测试命令，Denylist 加 `rm -rf` 和 `git push --force`。
五件事加起来不超过半小时，之后每一轮人机对话都在为你省时间。
## 参考来源
以下为官方入口，具体功能页在站内按关键词（Rules、@-symbols、.cursorignore、Checkpoints、Notepads、MCP）可直接检索到；文中价格与个别版本时间以官方页面实时为准。
1. Cursor 官方文档：https://cursor.com/docs
2. Cursor 定价页：https://cursor.com/pricing
3. Cursor 更新日志（Checkpoint、Notepads、Custom Modes 等均见于 2025 年各版本条目）：https://cursor.com/changelog
4. Cursor 官方论坛（规则写法与踩坑讨论区）：https://forum.cursor.com
---
> 本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵**爱卫生**（微信ID: gprshome201101）维护。
> 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。
