Cursor Notepads 怎么用？可复用的上下文文档

2026-06-17

Cursor Notepads 是 Cursor 里一种可复用的上下文文档：你把一段常用的背景信息（规范、API 说明、架构约定）写进一个 Notepad，之后在对话或 Cmd-K 里用 @ 把它整段引用进来，让 AI 立刻拿到这份上下文。简单说，它就是给你的项目准备的一摞「随手贴」，需要哪张就贴哪张，而不用每次手敲一遍。

这篇讲清 cursor notepads 用法：它和 .cursorrules 有什么不一样、怎么建、怎么用 @ 调用、放什么内容最划算，以及团队怎么共享。读完你能把项目里反复说的那些话，一次性沉淀下来。本文基于 Cursor 的功能逻辑，具体入口和快捷键以官方文档为准。

Notepads 是什么，和 .cursorrules 有什么不一样

很多人分不清 Notepads 和规则文件，其实定位完全不同：

.cursorrules / Project Rules 是”始终生效”的规则：它像项目的宪法，每次对话都自动注入，适合放”任何时候都要遵守”的硬约束（用什么框架、代码风格、禁止做什么）。
Notepads 是”按需调用”的上下文：它默认不生效，你 @ 它才进上下文。适合放”某些任务才需要”的大段背景——比如某个模块的 API 文档、一次性的重构方案、某类页面的生成模板。

一句话区分：规则是被动全局生效，Notepads 是主动局部引用。两者互补，不是二选一。常驻约束写进规则，零散但会反复用到的资料塞进 Notepads。关于规则文件本身怎么写，见 Cursor Rules 最佳实践（规划中）。

维度	.cursorrules / Rules	Notepads
生效方式	自动、全局	手动 `@` 引用
适合内容	硬性规范、风格约束	大段背景、模板、文档
灵活度	低（一改全改）	高（哪需要贴哪）
上下文成本	每次都占	只在引用时占

第一步：新建一个 Notepad

Notepads 在 Cursor 的侧边栏里有独立入口（通常和 Chat、Composer 并列）。新建一个 Notepad，给它起个一看就懂的名字——名字就是你之后 @ 时要敲的关键词，所以别叫”文档1”，叫 api-user、组件规范、数据库schema 这种。

Notepad 内部就是一个 Markdown 文档，你可以写标题、列表、代码块，也能贴图片、附文件引用。把它当成一篇给 AI 看的说明书来写就对了。具体新建入口位置以官方文档为准。

第二步：在对话里用 @ 引用它

这是 Notepads 的核心动作。在 Chat、Composer 或 Cmd-K 输入框里敲 @，候选列表里就会出现你的 Notepad（和 @文件、@代码库 一样的逻辑）。选中它，整篇 Notepad 的内容就被塞进这轮对话的上下文。

举个最小例子。你建了一个叫 api-user 的 Notepad，里面写：

# 用户接口约定
- 列表：GET /api/users，分页参数 page/size
- 详情：GET /api/users/:id
- 统一返回 { code, data, message }，code=0 为成功
- 出错时 data 为 null，message 给中文提示

之后你只要说：“@api-user 帮我写一个用户列表页的请求和渲染”，AI 就知道走哪个端点、字段长什么样，不会自己瞎编接口。你少打几十个字，它少猜一大半。

第三步：往里放”会反复用到”的东西

判断一段内容该不该进 Notepad，标准只有一条：这话你是不是会对 AI 说第二遍？ 会，就沉淀。常见的高价值内容：

项目规范与约定：命名规则、目录结构、提交信息格式、组件写法模板。
API / 数据结构说明：接口清单、字段含义、数据库 schema、枚举值对照表。
可复用的生成模板：比如”新建一个 CRUD 页面”要包含哪些部分、“写一个 React 组件”的骨架要求。
一次性但复杂的任务背景：某次大重构的方案、某个第三方库的接入要点，做完可以删。
踩过的坑 / 约定俗成：这个项目里”千万别动的地方”、历史遗留的特殊处理。

反过来，只生效一次、说完就忘的话不必进 Notepad，直接在对话里说更快。

三个可以直接抄的模板

光说”放什么内容”太抽象，给你三份能直接照抄改字段用的模板，抄完记得删掉不属于你项目的部分。

模板一：接口约定（api-order）

# 订单接口约定
- 列表：GET /api/orders，参数 status/page/size，status 可选 pending|paid|closed
- 创建：POST /api/orders，body 需要 sku_id、count、address_id
- 统一返回 { code, data, message }，code=0 成功，非 0 一律 toast 提示 message
- 金额字段单位是"分"，前端展示前要 /100，别再犯这个老错
- 时间字段是 ISO 字符串，禁止直接 new Date() 加减小时数（有时区坑）

这种模板的价值不在”写了什么”，而在”把项目里反复踩的坑写死”——比如上面那条”金额单位是分”，口头交代过八百遍的事，写进 Notepad 一次性解决。

模板二：组件规范（comp-rule）

# React 组件生成规范
- 一律函数组件 + TypeScript，禁止 class 组件
- 样式用 Tailwind，禁止内联 style 和额外的 .css 文件
- 状态优先用 useState，跨组件共享才上 Context，别一上来就用状态管理库
- Props 类型必须显式声明 interface，禁止 any
- 文件命名：组件用大驼峰（Button.tsx），hooks 用 use 前缀（useAuth.ts）

这类”生成骨架”的规范如果只放在 .cursorrules 里，容易和别的全局规则挤在一起变得又臭又长；单独拆成 Notepad，写组件时才 @ 它，规则文件本身能保持精简。

模板三：一次性重构方案（refactor-cart）

比如你正在把购物车模块从 Redux 迁到 Zustand，这种任务背景说一次占几百字，中途要反复对话好几轮，每轮都重新解释一遍就是浪费。做法是：开工前先把迁移范围、新旧 API 对应关系、暂不迁移的边界写进一个 Notepad，每轮对话开头 @ 一下，迁完就把这个 Notepad 删掉或归档，不留占位的垃圾文档。

常见误区：Notepad 不是越大越好

有人图省事，把整个项目的技术文档一股脑塞进一个 Notepad，指望”一 @ 全都有”。这么做的代价是：每次引用都要把这一大坨内容塞进上下文，模型要在几千字里翻你真正需要的那几行，既费 token 也容易让它抓错重点。经验值是：单个 Notepad 控制在能讲清一个主题的篇幅（几十到两三百行 Markdown），主题一多就拆开，别怕多建几个。

团队怎么共享 Notepads

Notepads 的另一个价值是沉淀团队共识。新人入职最怕的就是”项目里那些没写下来的规矩”，而 Notepads 正好能把这些隐性知识显性化：把接口约定、组件规范、架构决策各建一个 Notepad，新人 @ 一下就拿到老手脑子里的东西。

至于共享的具体落地方式——是随项目仓库走、还是靠 Cursor 的账号/团队功能同步——不同版本能力不一样，以官方文档为准。一个稳妥且长青的做法是：把这些上下文先以 Markdown 文件形式放进代码仓库（如 docs/ 目录），既能版本管理、走 Code Review，也能在需要时同步进 Notepad 或用 @文件 直接引用。这样即便工具形态变化，你的知识资产也不锁死在某个软件里。

新手常见坑

名字起得太随意：@ 调用全靠名字，名字模糊就找不到、也容易 @ 错。用”模块+类型”命名。
把硬规范塞进 Notepad：每次都要手动 @ 才生效，容易忘。真正”必须始终遵守”的东西应该进 Rules，不是 Notepad。
一个 Notepad 塞下整个项目：内容越长，@ 进来占的上下文越多、噪音越大。按主题拆分，用到哪块贴哪块。
写完就不维护：接口改了、规范变了，Notepad 不更新，AI 就按过期信息干活。把它当文档一样维护。
忘了它的存在：很多人建完一次就再没 @ 过。养成习惯——开始一个任务前先想”有没有现成的 Notepad 能贴”。

常见问题

Notepads 和 .cursorrules 到底用哪个？ 两个都用。始终要遵守的硬约束（框架、风格、禁区）写进 Rules，自动全局生效；特定任务才需要的大段背景（API 文档、模板、方案）放 Notepads，用 @ 按需引用。一个管”规矩”，一个管”资料”。

Notepad 里能放图片或引用文件吗？ 可以。Notepad 本质是 Markdown 文档，支持文字、列表、代码块，通常也能附图片和文件引用，适合把一类资料聚在一处。具体支持范围以官方文档为准。

Notepad 会一直占用上下文吗？ 不会。它默认不生效，只有你 @ 它的那一轮对话才会被读进上下文。这正是它比 Rules 灵活的地方——不引用就不花 token，用完即走。

怎么把 Notepads 共享给团队？ 官方提供的同步方式以文档为准。更稳的长青做法是把这些上下文以 Markdown 存进 Git 仓库的 docs/ 里，走版本管理和 Code Review，再按需同步进 Notepad 或直接 @文件 引用，知识不被工具绑架。

Cursor 新手想系统上手怎么办？ 建议先把 Cursor 的基础操作（Tab 补全、Cmd-K、Composer）跑顺，再用 Rules + Notepads 把项目上下文配齐，效率会有明显台阶式提升。

👉 看看我们的 AI 编程实战体系课，或逛 AI 编程教程大全把基本功打扎实。