首页 › tips-tricks › Cursor七道暗门：补全只是它的零头

Cursor七道暗门：补全只是它的零头

导语：大多数人把 Cursor 当成「会聊天的 VSCode」——Tab 补全、Ctrl+K 改段代码，就以为用完了。但翻一下 Cursor 官方文档（cursor.com/docs）会发现，编辑器里躺着一批存在超过一年的开关：给它立团队宪法的规则系统、让它现查官方文档的 @docs、挡住 .env 进上下文的 .cursorignore、一键回滚的 Checkpoint……这些功能讨论度远低于模型本身，却是「同一模型、两个段位」的分水岭。这篇把七道暗门一次拆开，每道都给具体操作路径，今晚就能用上。

为什么补全只是零头

Cursor 的输出质量 = 模型能力 × 喂进去的上下文质量。模型能力你控制不了（大家用的都是那几家），上下文工程才是普通用户和高手之间真正拉开差距的地方。下面七道暗门，本质上全是围绕「让 Agent 在正确的时机、看到正确的材料、做有限的动作」设计的。

暗门一：`.cursor/rules`——给 Agent 立一部团队宪法

90% 的人还在干两件蠢事：要么每次对话手动粘贴代码规范，要么根本不写规范、让模型每次自由发挥。

正确做法是在仓库根目录建 .cursor/rules/ 目录，规则拆成 .mdc 文件，支持 frontmatter 控制生效范围：

---
description: API 接口统一规范
globs: src/api/**/*.ts
alwaysApply: false
---
- 所有接口返回统一包装 { code, data, message }
- 错误码沿用 errno.ts 中的枚举，禁止新造数字
- 分页参数固定为 page / pageSize

三个关键点：

globs 自动挂载：只有改到 src/api/** 下的文件时，这条规则才会进上下文——不用每轮对话白耗 token。
规则里可以 @ 引用文件：写 错误码见 @src/constants/errno.ts，Agent 会自己去读。
让 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

两个直接收益：

安全：.env 里的数据库密码、第三方 API Key 不会再作为上下文片段泄漏出去。做等保或有合规要求的团队，这一行配置比口头叮嘱有用得多。
省 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：

{
  "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 快一个量级。

一张图看懂七道暗门怎么协同

flowchart TD
    A["你发出一句需求"] --> B["规则层<br/>.cursor/rules 按文件自动注入"]
    B --> C["闸门层<br/>.cursorignore 先过滤"]
    C -->|白名单文件| D["引用层<br/>@docs @git @Notepad"]
    C -->|命中忽略规则| E["密钥与无关文件<br/>永不进入上下文"]
    D --> F["模型层<br/>生成改动与命令"]
    F --> G{"终端闸门"}
    G -->|命令在白名单| H["自动执行<br/>跑测试起服务"]
    G -->|命令危险或陌生| I["暂停等你批准"]
    F --> J["Checkpoint 快照"]
    J --> K["不满意<br/>一键回到改动前"]

信息差总结

你以为的 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），足够先验证再决定要不要付费。

行动指南

今晚回到工位，按顺序做五件事：

建仓库规则：.cursor/rules/api.mdc，把你团队接口规范抄成模板（见暗门一代码块），十分钟搞定。
写上下文防火墙：把 .env、构建产物、陈年遗留目录全部写进 .cursorignore。
挂文档库：把你最常用框架的官方文档 URL 加进 @Docs，从今天起提问先 @ 文档。
存一个 Notepad：名字叫「标准请求响应样例」，粘上你们项目的样板代码。
配终端白名单：Allowlist 加 npm run * 和测试命令，Denylist 加 rm -rf 和 git push --force。

五件事加起来不超过半小时，之后每一轮人机对话都在为你省时间。

参考来源

以下为官方入口，具体功能页在站内按关键词（Rules、@-symbols、.cursorignore、Checkpoints、Notepads、MCP）可直接检索到；文中价格与个别版本时间以官方页面实时为准。

Cursor 官方文档：https://cursor.com/docs
Cursor 定价页：https://cursor.com/pricing
Cursor 更新日志（Checkpoint、Notepads、Custom Modes 等均见于 2025 年各版本条目）：https://cursor.com/changelog
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 等场景全覆盖。

51学通信知识星球海报-扫码加入