金句：大多数人用 Cursor 只用到了 10% 的能力——他们把它当成了更快的记事本，而不是一个会思考的协作者。
一、你真的会用 Cursor 吗？
2024年，Cursor 月活突破 100 万。同年，一项开发者调查显示：超过 60% 的用户表示只使用了 Cursor 的"基础聊天功能"，从未深入探索过其他核心能力。
这就像买了一辆特斯拉，却只用来挡风遮雨。
本讲将系统梳理 Cursor 的 7 个使用阶段，从"Hello World"到工程级别的代码架构协作，帮你真正解锁这个工具的全部潜力。
二、Cursor 的核心架构：你在和谁对话？
在深入之前，先理解 Cursor 的技术架构，这决定了你该如何使用它。
┌─────────────────────────────────────────────────────┐
│ Cursor IDE │
│ ┌──────────────┐ ┌──────────────┐ ┌───────────┐ │
│ │ 代码编辑器 │ │ Chat 面板 │ │ Composer │ │
│ │ (VSCode) │ │ (对话式) │ │ (Agent模式)│ │
│ └──────────────┘ └──────────────┘ └───────────┘ │
│ ↑ ↑ ↑ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Cursor 上下文引擎 │ │
│ │ • 文件索引 • 代码语义 • @引用系统 │ │
│ └─────────────────────────────────────────────────┘ │
│ ↑ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ AI 模型层（Claude / GPT-4o / 自定义） │ │
│ └─────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘
关键理解：Cursor 不是一个聊天框，它是一个上下文管理引擎，核心价值在于如何把正确的代码信息注入到 AI 的上下文窗口中。
三、7 个使用阶段详解
阶段一：补全向导（Level 1）
使用方式：只用 Tab 键自动补全
典型用户：刚安装 Cursor 的人
特征：
- 依赖 AI 猜测下一行代码
- 被动接受建议，很少主动引导
- 生产力提升：约 20%
进阶信号：当你发现 AI 补全的代码"不够准确"时，说明你需要主动给它更多上下文。
阶段二：问答助手（Level 2）
使用方式：在 Chat 面板提问
典型对话：
用户：这个函数是什么意思？
用户：帮我写一个排序算法
用户：这个报错怎么解决？
局限：每次对话是孤立的，AI 不知道你的项目背景。
进阶技巧：开始使用 @ 引用语法。
阶段三：上下文引用（Level 3）
这是从"聊天工具"到"代码助手"的关键跨越。
@ 引用系统全解：
@文件名 → 引入整个文件内容
@文件夹 → 引入目录结构
@代码块 → 引入选中的代码片段
@Docs → 引入官方文档（需提前添加）
@Web → 实时联网搜索
@Codebase → 全项目语义搜索
@Git → 引入 Git 历史/diff
实战示例：
"@UserService.ts @AuthMiddleware.ts
这两个文件的权限验证逻辑有什么不一致的地方？"
现在 AI 看到了真实的代码，而不是在凭空猜测。
阶段四：规则驱动（Level 4）
核心工具：.cursorrules 文件（新版为 Cursor Rules）
# .cursorrules 示例
## 项目技术栈
- 后端：Node.js + TypeScript + Fastify
- 前端：React 18 + Zustand + TailwindCSS
- 数据库：PostgreSQL + Prisma ORM
- 测试：Vitest + Testing Library
## 代码风格规范
- 使用函数式组件，禁止 class 组件
- 异步操作必须使用 async/await，禁止 .then() 链
- 错误处理使用 Result<T, E> 模式，禁止裸 throw
- 所有公共函数必须有 JSDoc 注释
## 命名规范
- 组件文件：PascalCase（UserProfile.tsx）
- 工具函数：camelCase（formatDate.ts）
- 类型/接口：PascalCase + Type/Interface后缀
## 禁止事项
- 禁止使用 any 类型
- 禁止直接修改 Redux/Zustand state
- 禁止在组件中直接调用 API，必须通过 service 层
有了这个文件，AI 的每次输出都会自动遵循你的项目规范。
阶段五：Composer 工程模式（Level 5）
什么是 Composer？
Composer 是 Cursor 的 Agent 模式，可以同时修改多个文件、创建新文件、执行终端命令。
适用场景：
- 实现一个完整的功能模块
- 重构整个目录
- 从设计稿生成完整的前端页面
Composer 最佳实践：
[任务描述]
实现用户认证模块
[需要创建/修改的文件]
- src/auth/AuthService.ts（新建）
- src/auth/AuthController.ts（新建）
- src/auth/dto/LoginDto.ts（新建）
- src/middleware/JwtMiddleware.ts（新建）
- src/app.module.ts（修改，注册新模块）
[技术要求]
- JWT + Refresh Token 双令牌机制
- 密码使用 bcrypt 加密，salt rounds = 12
- Access Token 有效期 15 分钟，Refresh Token 7 天
- 遵循 @.cursorrules 中的代码规范
[验收标准]
- POST /auth/login 返回 { accessToken, refreshToken }
- POST /auth/refresh 使用 refreshToken 换新 accessToken
- POST /auth/logout 使 refreshToken 失效
关键技巧：Composer 的任务描述越具体，文件范围越明确，输出质量越高。
阶段六：调试协作（Level 6）
使用方式：将报错信息、堆栈跟踪直接粘贴到 Chat，配合代码上下文
高效调试模板：
## 报错信息
[粘贴完整错误堆栈]
## 复现步骤
1. 启动服务：npm run dev
2. 访问 /api/users/123
3. 触发报错
## 相关代码
@UserController.ts @UserService.ts @PrismaClient
## 我已尝试的方案
- 检查了数据库连接，连接正常
- 打印了 userId，值为 "123"（字符串）
## 期望结果
返回用户对象，状态码 200
这种结构化的调试请求，能让 AI 在第一次就给出精准的解答。
阶段七：架构设计协作（Level 7）
这是最高阶的使用方式——将 Cursor 作为你的架构设计搭档。
使用场景：
- 系统设计阶段（Before coding）
- 技术选型决策
- 性能优化方案评审
架构设计对话示例：
"我正在设计一个支持 10 万并发的消息推送系统。
当前技术栈：Node.js + PostgreSQL。
主要需求：
- 用户订阅频道，实时接收消息
- 消息需要持久化，支持离线消息
- 需要支持消息回执（已读/未读）
请分析以下三种架构方案的优劣：
1. WebSocket + Redis Pub/Sub
2. Server-Sent Events + 消息队列
3. 长轮询 + 数据库直连
给出你的推荐方案和理由。"
四、Cursor 7 个阶段自测表
┌────────┬────────────────────────────┬──────────┐
│ 阶段 │ 核心能力 │ 自测问题 │
├────────┼────────────────────────────┼──────────┤
│ L1 │ Tab 补全 │ 会用吗？ │
│ L2 │ Chat 问答 │ 会用吗？ │
│ L3 │ @ 引用上下文 │ 会用吗？ │
│ L4 │ .cursorrules 规则文件 │ 配置了吗？│
│ L5 │ Composer 多文件操作 │ 会用吗？ │
│ L6 │ 结构化调试协作 │ 用过吗？ │
│ L7 │ 架构设计协作 │ 尝试过吗？│
└────────┴────────────────────────────┴──────────┘
五、课后实践任务
任务：在你的现有项目中，完成以下 3 个操作：
- 配置
.cursorrules：写一个至少 20 行的规则文件，包含技术栈、代码规范、禁止事项 - 使用 Composer 实现一个功能：选择一个你一直想做但拖着没做的小功能，用 Composer 实现它
- 记录时间：对比"纯手写"和"Cursor 辅助"完成同类任务的时间差
下一讲，我们进入 GitHub Copilot 的深度使用，看看两大工具各自的独特优势。
章节小结：Cursor 的核心不是"更快的代码补全"，而是上下文管理艺术。7 个阶段中，L3（@引用）到 L5（Composer）是最容易被忽视却价值最高的跨越区间。掌握这些，你才真正开始使用 Cursor。
