Hi～大家好呀，我是清汤饺子。
前几天不是写了几篇 Cursor 技巧嘛，很多朋友看完说挺有用的。但也有人说：饺子啊，有没有更系统的教程？我想从零开始学。
好！那我就出一个系列教程，手把手教你。
这个系列一共三篇：
第一篇（就是这篇）：从零上手 Cursor
讲讲怎么安装、Agent 怎么用、怎么写功能、怎么修 Bug
第二篇：让 Cursor 更懂你
上下文引用、Rules、Skills、MCP 这些
第三篇：团队协作与场景实战
怎么在团队里用好 Cursor
你要是刚装好 Cursor，打开一看界面和 VS Code 差不多，然后就不知道干嘛了——这篇文章就是给你看的～
读完以后，你能用 Cursor 读懂一个陌生项目，写一个新功能，修一个 Bug。咱们开始吧！
前言
这个系列是写给谁的
这篇文章是给第一次装 Cursor 的朋友看的。如果你：
- 刚下载好 Cursor，但不知道怎么用
- 知道一点但感觉用起来不顺手
- 想系统学一下怎么用好这个工具
那这篇文章就是给你看的。
学完能做什么
读完这篇文章，你能：
- 独立用 Cursor 读懂一个陌生项目
- 让 Agent 帮你写新功能
- 独立修复 Bug
- 用 Plan Mode 处理复杂任务
一、Cursor 是什么？为什么要用？
1.1 AI 编辑器和传统编辑器有什么区别
VS Code、JetBrains 这些编辑器咱都用过吧？你写代码，编辑器帮你高亮、补全、报错。你是主体，编辑器是工具。
Cursor 不一样。你告诉它你想做什么，AI 帮你写代码，你来审查和决策。简单说：以前你自己动手，现在 AI 给你打下手，你来把关。
1.2 Cursor 能帮你干什么
凡是你能说清楚的编程任务，Cursor 都能帮你做。
具体场景：
- 读陌生代码：刚接手新项目，让 AI 帮你梳理结构
- 写新功能：告诉 AI 你想加什么，它帮你找文件、改代码
- 修 Bug：报错信息丢给 AI，它帮你定位问题
- 重构代码：让 AI 按你的规范整理代码
- 写测试：根据现有代码生成测试用例
1.3 适合谁用
- 需要快速接手陌生项目的开发者
- 想提高编码效率的前端/后端工程师
- 经常在多个文件之间来回改动的同学
- 任何语言的开发者——Cursor 不挑语言
二、安装和第一次使用
2.1 下载安装
去 cursor.com/downloads 下载对应平台的安装包。
macOS：下 .dmg 安装就行。 Windows：下 .exe 安装。 Linux：用 apt 或 yum 安装，最方便。
2.2 登录账号
安装完打开 Cursor，会提示你登录。注册一个账号就行，免费计划够用。
2.3 从 VS Code 迁移设置
如果你之前用 VS Code，可以一键导入全部配置：
- 打开 Cursor 设置：Cmd/Ctrl + Shift + J
- 点 VS Code Import
你的扩展、主题、快捷键就都过来了，不用重新配置。
💡 小提示：Cursor 的活动栏默认是水平的。如果你习惯垂直的，在设置里搜 workbench.activityBar.orientation，改成 vertical 重启就行。
三、Agent 模式：你的 AI 编程搭档
3.1 Agent 是什么
Agent 是 Cursor 的核心功能。一个能独立完成编程任务的 AI 助手。
你可以理解为：它不是简单问你答，而是有个"工具箱"——可以搜代码、改文件、跑命令，直到把任务完成。
3.2 怎么触发 Agent
按 Cmd+I（macOS）或 Ctrl+I（Windows/Linux），右边会弹出 Agent 面板。
3.3 怎么和 AI 对话让它帮你改代码
记住一个原则：说清楚"做什么"，而不是"怎么做"。
✅ 好的例子：
在登录页面把错误提示改成更友好的文案
❌ 不好的例子：
改一下登录页面
还可以用 @文件名 把相关文件带进来：
参考 @src/pages/Login.tsx，把登录失败的提示改得更友好
3.4 Agent 执行过程中你可以随时干预
Agent 干活的时候，你能看到它在做什么。如果它跑偏了，随时可以：
- 点 Stop 中止
- 直接输入新指令纠正
- 回滚到某个 Checkpoint 重来
3.5 Checkpoint 是什么
就是"后悔药"。Agent 做重大改动前会保存快照，搞砸了点一下就能恢复。
⚠️ 注意：Checkpoint 是本地快照，和 Git 是两回事，不能替代 Git 提交哦。
四、Plan Mode：先想清楚再动手
4.1 什么是 Plan Mode
Agent 默认模式下，你说一句话它就开始改代码。这对小改动很高效，但遇到复杂任务——比如要改十几个文件——直接动手很容易跑偏。
Plan Mode 就是来解决这个问题的：先规划，再执行。
进入 Plan Mode 后，Agent 不会立刻写代码，而是：
- 问你几个问题，把需求搞清楚
- 搜一下代码库，了解现有实现
- 生成一份实施计划
- 等你审批
- 你确认后，再开始执行
4.2 怎么切换
在 Agent 输入框里按 Shift+Tab。
4.3 什么时候用
适合用：
- 改动涉及多个文件
- 需求还不确定具体怎么做
- 有多种实现方案，想让 AI 分析利弊
不适合用：
- 改一行文案、修一个明确的小 Bug——直接用 Agent 就好，用 Plan Mode 反而浪费时间
4.4 计划出错了怎么办
我的经验是：不要用追问修补，越补越乱。更好的做法是回滚改动，回到计划，重新描述问题，然后重来一次。
重来一次看起来慢，其实比打补丁快得多。
五、让 AI 帮你读懂陌生代码
5.1 刚接手新项目怎么办
最难受的不是代码难，是不知道从哪里开始读。入口在哪？核心逻辑在哪？
过去你只能一个文件一个文件地读，或者等同事有空带你过一遍。
现在可以直接问 Cursor。
5.2 让 Cursor 解释项目结构
打开项目，按 Cmd+I，直接问：
帮我看看这个项目的整体结构，入口文件在哪、核心模块有哪些
Cursor 会搜一遍代码库，给你梳理得明明白白。这是熟悉陌生项目最快的方式。
5.3 还能生成架构图
可以让 Cursor 生成 Mermaid 图来可视化：
用 Mermaid 图描述一下支付系统的数据流
这类图对理解大型项目特别有用。
5.4 动手之前先探索
一个常见错误：没搞清楚项目里已有什么，就让 AI 去新增功能。结果 AI 造了一个轮子，而项目里早就有了。
正确的做法：先探索，再改动。
在动手之前，先告诉我这个项目里表单验证是怎么做的
搞清楚以后再让 AI 新增，代码风格会一致，也不会重复造轮子。
六、用 Cursor 写新功能
6.1 多文件协作怎么玩
写一个新功能，往往要同时改好几个文件。手动来回切换很低效。
Cursor 的 Agent 天然支持多文件操作。你只需要描述清楚功能要求，它会自己找到需要改动的文件，逐一修改：
给用户设置页面新增通知偏好功能，参考 @src/pages/Settings.tsx 的布局
对于这种跨多个文件的任务，建议先走一遍 Plan Mode。
6.2 diff 怎么审
Agent 改完代码后，你能看到完整的 diff——哪些行被删除（红色），哪些行被新增（绿色）。
审 diff 几个要点：
- 改动是否符合你的意图
- 有没有改到不该改的地方
- 是否遵循了现有代码风格
你也可以直接让 Agent 帮你审：
审查一下这次改动，有没有 Bug
6.3 怎么跑测试
让 Agent 直接跑测试：
跑一下这次改动相关的测试，看有没有挂掉的
Agent 内置 Terminal 工具，可以直接执行命令，把测试结果反馈给你。
6.4 用 TDD 效果更好
推荐先写测试再让 AI 实现：
- 告诉 Agent 写测试，明确说不要写实现代码
- 让 Agent 跑测试，确认测试失败（说明测试有效）
- 把测试文件提交到 Git（锁定需求）
- 再让 Agent 写实现代码
- 测试全绿后，审查代码并提交
七、用 Cursor 修 Bug
7.1 修 Bug 的基本原则
不管是人还是 AI 调试，有效的流程都遵循同样逻辑：
- 能稳定复现：不能复现的 Bug 无从验证是否修好
- 缩到最小范围：把无关的东西剥离
- 一次只改一个变量：同时改三个地方 Bug 消失了，你不知道哪个起了作用
- 修完写回归测试：防止同一个 Bug 再次出现
7.2 第一步：把报错信息直接给 Agent
如果有明确报错，最简单的方式是把错误信息粘贴进去：
这个测试在报错： TypeError: Cannot read properties of undefined 帮我找到根本原因并修复
Agent 会沿着调用栈读取相关文件，追溯到真正的问题所在。
7.3 第二步：缩小范围
对于原因不明显的 Bug：
结账流程会间歇性失败，没有固定报错。帮我分析可能的原因
Agent 会结合代码结构提出几个假设。
7.4 第三步：用 Debug Mode 处理疑难杂症
简单 Bug 把报错丢给 Agent 通常就够了。但如果遇到：
- 能复现但看不出原因
- 竞态条件问题
- 性能问题、内存泄漏
切换到 Debug Mode（在 Agent 输入框下拉菜单选，或按 Shift+Tab）。
Debug Mode 工作方式不同——它不会立刻猜原因改代码，而是：
- 提出假设：列出几个可能的根因
- 插入日志：在关键位置加日志
- 让你复现：告诉你怎么操作
- 分析日志：读取运行时数据
- 精准修复：只改几行
- 验证并清理：修完后再复现，然后删除日志
7.5 第四步：给 Agent 喂运行时数据
光看代码有时候找不到问题，把运行时数据直接给 Agent 效果更好。
比如直接粘贴终端输出或日志：
这个查询跑 1.2 秒，这是 EXPLAIN ANALYZE 的输出，帮我看看为什么这么慢
Agent 可以直接判断出原因。
7.6 第五步：修完写回归测试
找到 Bug、修复之后，写一个回归测试，防止同样问题再次出现。
7.7 一个需要注意的坑
不要接受你看不懂的修复。
Agent 给出的修复方案，如果你自己都没看懂，就不要直接接受。
我的习惯是：让 Agent 解释修复逻辑，搞懂之后再接受。遇到说不清的，继续追问。
小结
| 场景 | 怎么做 |
|---|---|
| 安装 Cursor | 下载安装包，一键导入 VS Code 配置 |
| 启动 Agent | Cmd+I，用自然语言描述任务 |
| 复杂任务 | Shift+Tab 切换 Plan Mode |
| 读陌生代码 | 问 AI 解释项目结构 |
| 写新功能 | 描述需求 → Agent 改动 → 审 diff → 跑测试 |
| 修 Bug | 粘贴报错 → 缩小范围 → Debug Mode → 回归测试 |
下一步
这篇讲的是"能用起来"——你已经可以用 Cursor 干日常的活了。
但 Cursor 真正强大的地方在于你能把它调教成最懂你的搭档。这需要上下文管理、Rules、Skills、MCP 等。这些内容放在第二篇讲。
第二篇预告：让 Cursor 更懂你——上下文管理、自定义规则与进阶工具
- @file、@folder 怎么用
- 用 Rules 把项目规范写给 AI
- 用 Skills 封装工作流
- MCP：接上 Figma、数据库
- Subagents：多 AI 并行工作
- CLI：在终端用 AI
好了，这篇就先到这里。
觉得有帮助的话，点个赞收藏一下，后续更新也能第一时间看到～
有问题欢迎在评论区问我，咱们下篇见！
也欢迎关注我的公众号「清汤饺子」，获取更多技术干货！
