说实话，我刚开始用 Cursor 的时候也只是把 Notepads 当成个能保存片段的高级备忘录，后来深入项目实战之后才发现，它完全不止于此。
今天苏米就手把手带大家深入了解 Cursor Notepads，从基础概念到高级实践，相信看完这篇文章，你会对 Cursor 的使用有一个全新的认识。
Notepads 到底能干嘛？
简单说，它是 Cursor 里的“结构化知识空间”。
核心能力总结如下：
-
✅ 跨窗口上下文共享：Composer 和 Chat 能共享同一份知识，不卡壳
-
✅ 支持附件：插文档、贴图片、挂 JSON，全都可以
-
✅ @动态引用：像引用代码一样，引用 Notepad 中的内容
-
✅ 支持 Markdown + 结构化组织：你写得清楚，AI就理解得清楚
核心应用场景
场景一：项目知识与架构管理
场景还原：
团队接新项目，大家对架构认知不一致，沟通成本爆炸。
示例结构：
# 系统架构概览
## 核心技术栈
- 前端：React 18.2 (选择理由：团队熟悉度高，生态完善)
- 后端：Node.js 18 LTS (选择理由：与前端技术栈统一，降低学习成本)
- 数据库：MongoDB 6.0 (选择理由：适合快速迭代的文档结构)
## 关键模块与接口
- 认证模块：JWT 方案，详见 @auth-flow.md
- 数据模块：MongoDB 模式设计，详见 @data-schema.json
- API层：RESTful 接口，详见 @api-spec.yaml
实际案例： 在 Cursor Chat 中引用架构文档：
请参考 @系统架构概览 给出用户认证模块的实现方案
通过引用 Notepad 内容，AI 可以获取完整的项目架构信息，确保生成的代码完全符合团队的设计规范。
场景二：编码规范与模板库
统一的编码规范对项目维护来说至关重要，但很多团队都是口头约定，缺乏系统化的管理。
实践要点：
-
建立团队共识的代码风格指南，而非基于个人喜好
-
收集项目中反复出现的代码模式和最佳实现
-
整理可复用的解决方案，大幅提高开发效率
规范示例：
# API开发规范
## 端点结构
- 坚持RESTful约定，保持接口的一致性和可预测性
- 基础URL：`/api/v1`，便于未来版本升级
- 资源命名使用复数形式（如users, products）
## 响应格式
{
"status": "success|error",
"data": {}, // 成功时返回的数据
"message": "操作成功/失败的具体描述"
}
@api-examples.json // 附带真实示例
实际案例： 在 Cursor Chat 中引用规范文档：
参考 @API开发规范 帮我重构用户资源的CRUD接口，需要兼容新的权限系统
这样生成的代码完全符合团队标准，避免了后续的反复修改，节省了大量代码审查的时间。
什么内容值得写进 Notepads？
| 类型 | 是否推荐 | 理由 |
|---|---|---|
| ✅ 项目架构、模块设计 | 必写 | 是项目决策的核心 |
| ✅ 编码规范 & 模板代码 | 必写 | 是团队协作基础 |
| ✅ API文档、接口示例 | 推荐 | 有利于 AI 调用 & 新人理解 |
| ✅ 入职指南、开发环境配置 | 推荐 | 新人上手快 |
| ❌ 密钥、配置、临时笔记 | 不推荐 | 安全风险 + 易失效 |
| ❌ 核心代码 | 不推荐 | 应该放 Git，非 AI 知识域 |
Notepads vs Rules，怎么选？
在实际使用中，苏米总结了这两个功能的核心差异：
| 特性 | Cursor Notepads | Cursor Rules |
|---|---|---|
| 适用场景 | 复杂知识管理、团队协作文档 | 简单 IDE 配置、基本规则 |
| 支持附件 | ✅ 支持 | ❌ 不支持 |
| 动态引用 | ✅ 支持 @ 语法 | ❌ 有限支持 |
| 最佳用途 | 深入指南与知识库 | 简明规则与配置 |
高级技巧
技巧一：构建模块化知识体系
不要把所有内容都塞在一个 Notepad 里，而是要建立模块化的知识体系：
# 主项目文档 (@main-project)
- 引用 @architecture-guide
- 引用 @coding-standards
- 引用 @api-documentation
# 架构指南 (@architecture-guide)
- 系统设计原则
- 技术选型理由
- 模块划分策略
# 编码规范 (@coding-standards)
- 代码风格指南
- 命名约定
- 注释规范
技巧二：版本化管理重要文档
对于关键的架构决策和规范文档，建议加上版本标识：
# API设计规范 v2.1
更新日期：2024-01-15
更新内容：增加分页参数规范
## 变更记录
- v2.1: 增加分页参数规范
- v2.0: 统一错误码体系
- v1.0: 初版发布
技巧三：团队协作工作流
在团队中使用 Notepads 时，建立清晰的协作流程：
-
指定负责人：每个重要的 Notepad 都有明确的维护者
-
定期更新：设置固定的文档review周期
-
统一命名：建立团队统一的命名规范
-
权限管理：合理分配编辑和只读权限
几个小 Tips：
-
写 Notepads 就像写给 AI 的设计文档 —— 写得清楚，它就理解得好。
-
标题要有层级感 ——
# 一级标题、## 二级标题，AI 才能正确分块。 -
加附件别手软 —— JSON、截图、接口文档都能贴，AI 理解更精准。
-
用 Chat 多引用 Notepads 训练 AI 路线 —— AI 越用越聪明。
结语
你想让 AI 做对事，得先教会它“你怎么想”。Notepads 就是这个桥梁。
在我的项目实战中，Notepads + Rules = AI 项目执行力倍增器。文档写好了，沟通少一半，返工少三成，代码统一性高一截。
如果你还没有开始使用 Cursor Notepads，苏米强烈建议你从今天就开始尝试。从一个简单的项目规范文档开始，逐步建立你的知识体系。相信很快你就会发现，这个看似简单的功能，竟然能带来如此巨大的效率提升。
最后，如果你在使用过程中遇到任何问题，或者有更好的实践经验，欢迎在评论区和苏米交流。让我们一起把 Cursor 这个强大的工具用到极致！
下面几篇关于Rules的文章，也可以学习一下：
Cursor Project Rules 进阶指南：从规则到工程化思维，Project Rules 实战技巧与模板分享