一句话总结
Cursor 就是装了五个 AI 面板的 VS Code。安装两分钟搞定,真正的功夫在于把面板和任务对上号。Tab 补全你正在敲的这一行,Inline 编辑(Cmd-K) 重写选中的那段代码,Composer(Cmd-I) 做可逐块审阅的跨文件改动,Chat(Cmd-L) 在不碰代码的前提下问问题,Agent 模式 则让 Composer 自己跑终端命令、自己修错、不停下来等你点确认。免费的 Hobby 档足够你评估;Pro 是每月 20 美元(截至 2026 年 6 月)。这篇带你从全新安装到四次真实编辑,大约一小时。
这篇讲什么
Cursor 自称”带 AI 的 VS Code”,但真正的学习曲线在于”什么时候用哪个 AI 面板”。Tab 补全、Inline 编辑、Composer、Chat、Agent 各有甜蜜区和失败模式。这篇讲安装、第一次索引、模型选择,以及四次真实编辑——每个 AI 面板各一次——一小时后你就知道该按哪个键。
这篇适合谁看
想把 AI 留在编辑器里、而不是放在单独 chat 标签的开发者。从纯 VS Code 或 JetBrains 切过来基本无摩擦——Cursor 本身就是 VS Code 的分支,你的扩展、主题、键位都能带过来。想要更完整的流程(Inline vs Composer vs Chat、索引、@Files、回滚),先看Cursor 新手怎么开始——30 分钟跑通完整工作流。
五个面板速览
Cursor 3(截至 2026 年 6 月的当前版本)把 AI 功能重排成了 agent 优先的布局,但下面这五个面板仍然是你靠快捷键去找的那几个。学习时把这张决策表开着:
| 面板 | 快捷键(macOS / Win-Linux) | 干什么 | 什么时候用 |
|---|---|---|---|
| Tab | Tab | 预测你下一步编辑,常常跨多行、甚至跳到下一处 | 正打到一半、下一个 token 很明显 |
| Inline 编辑 | Cmd-K / Ctrl-K | 用提示框就地重写选中的代码块 | 只改一个函数或一个块 |
| Composer | Cmd-I / Ctrl-I | 一次改多个文件,再给你一份可逐块审阅的统一 diff | 改动跨好几个文件、你想逐 hunk 审 |
| Chat | Cmd-L / Ctrl-L | 回答问题;除非你主动 apply,否则不改代码 | ”这段代码为什么这样?“或动手前先规划 |
| Agent 模式 | 在 Composer 内 / Agents 窗口 | Composer 去掉逐步确认——读文件、写代码、跑终端命令、读 stdout、自己修错、循环到完成 | 较大的任务,你愿意让它跑、最后再统一审 |
一个常见误解:Composer 没有被改名成 Agent。Composer 是面板,Agent 是面板里那个去掉逐步确认、能自己跑命令的模式。在 Cursor 3 里你还可以 Cmd-Shift-P → "Agents Window",在一个侧栏里看到所有正在跑的 agent(本地和云端)。
开始前准备
- 拿一个真仓库测试——不要新建一个空
npm create。Cursor 的价值在规模上体现,它会拿周围的代码当上下文。 - 知道项目约定:lint 规则、formatter、test 命令。在干净基线上 Cursor 产出的代码更整洁。
- 第一次 AI 编辑选一个低风险、可回滚的小任务。
- 想好模型策略。免费的
Auto模型(会路由到 Composer 2.5 和更便宜的模型)应付大多数编辑都够;需要时再从选择器里按单次请求切到具名的旗舰模型。
具体步骤
- 从 cursor.com 安装。首次启动会问要不要导入 VS Code 的设置、扩展和键位——接受;导入不破坏原配置,也不动你原来的 VS Code。
- 打开项目,它会自动开始索引(看仓库大小,30 秒到几分钟)——它在本地建一个 embedding 索引,好把相关文件拉进上下文。首次索引前就加好
.cursorignore,排除node_modules、构建产物、大数据文件。如果是陌生仓库,等索引时可以在 Chat 里跑一遍让 AI 帮你做代码库导览的工作流。 - 打开模型选择器(任意 AI 面板右下角的模型名)。一开始保持
Auto——Auto 在成本和能力之间平衡,和 Composer 2.5 共用一个用量池但更便宜。难一点的 agent 任务再固定到Claude Sonnet 4.6或Opus 4.7,终端密集的活用GPT-5.5,快速的 inline 编辑用Composer 2.5。 - 先试 Tab 补全。打函数签名、停一下、按
Tab接受建议。Tab 是风险最低的面板,也是你一天用 100 次的那个。它不只补全这一行,常常还预测你在文件别处的下一步编辑。 - 试 Inline 编辑(
Cmd-K/Ctrl-K)。选一个函数、按快捷键、描述改动:“改成 async/await,保留错误处理。“先想清楚什么时候用 agent、什么时候用自动补全,免得一行小改也开 Composer。 - 试 Composer(
Cmd-I/Ctrl-I)做跨文件编辑。任务用两三句话描述、文件范围要明确:“在src/api/把每一处request.json()调用改成await request.json()。不要碰测试。“每个 diff 接受前都逐块审。 - 试 Chat(
Cmd-L/Ctrl-L)做讲解和探索。Chat 默认不改代码——它回答、你决定怎么应用。选中有问题的代码按Cmd-Shift-L/Ctrl-Shift-L,能把选区直接塞进 Chat。
第一次实操怎么跑
- 选一个小且孤立的任务:跨几个文件重命名变量、补 prop 类型、给一个模块加 JSDoc。可回滚、低风险。
- 一种做法用 Inline 编辑,另一种用 Composer,直接对比体验。
- 标哪个面板适合哪种任务。规律稳定:单函数改 → Inline;跨文件改 → Composer;“为什么这段代码这样?”→ Chat;“补完这一行”→ Tab。
- AI 编辑之间提交。每一步独立 commit,回滚更容易,也能用
git diff看清 Cursor 到底动了什么。
Cursor 价格(截至 2026 年 6 月)
付钱之前,你完全可以在免费档把每个面板都学会。以下是 cursor.com/pricing 上当前的个人和团队套餐:
| 套餐 | 价格(美元/月) | 年付 | 适合谁 |
|---|---|---|---|
| Hobby | 免费 | — | 评估用;Tab 补全和 Agent 请求有限,免信用卡 |
| Pro | $20 | 年付约合 $16/月 | 个人每天用;Agent 上限更高、$20 旗舰模型额度、MCP 和云端 agent |
| Pro+ | $60 | — | agent 用量更重、额度更多 |
| Ultra | $200 | — | 重度用户,一整天跑长 agent 会话 |
| Teams(Business) | $40 每席 | — | 集中计费、SSO、团队级隐私模式、Bugbot 代码评审 |
2025 年 6 月 Cursor 从按请求计费改成按用量计费:固定月费 + 内含的额度,超了再按量另收。免费 Hobby 档在每天用的强度下很快就撞到 Tab 和 Agent 上限;对大多数在职开发者来说,Pro 一周内就值回票价。
模型怎么选
Cursor 把自家模型和各家旗舰模型放在同一个选择器里。一个起步建议(2026 年 6 月):
| 模型 | 适合 | 成本备注 |
|---|---|---|
Auto / Composer 2.5 | 快速 inline 编辑、重构、日常 agent 任务 | 最便宜;Composer 2.5 的每 token 成本大约只有旗舰模型的十分之一 |
Claude Sonnet 4.6 | 需要更强判断力的长 agent 任务 | 中等;100 万 token 上下文 |
Claude Opus 4.7 | 难的架构决策、设计意见(SWE-bench Verified 87.6%) | 最高;留给真正难的任务 |
GPT-5.5 | 终端密集的活(Terminal-Bench 2.0 领先,82.7%) | 偏高 |
Gemini 3.1 Pro | 读多的评审通读、大上下文推理 | 每 token 偏低 |
Composer 2.5 于 2026 年 5 月 18 日发布,在三个公开基准里有两个追平了 Opus 4.7 和 GPT-5.5,而每 token 成本大约只有十分之一——这就是为什么 Auto 适合当大多数编辑的默认。把贵的模型留给真正难的活。
完成后检查
- 每个 Composer diff 都审。Cursor 偶尔会动你没想动的文件,拒掉那些 hunk。
- 跨文件编辑后跑全套测试。Cursor 抓类型错,不抓行为回退。
- 确认
.cursorignore真的排除了你想排除的。索引隐私数据或构建产物又慢又有隐私风险。 - 确认在用的是你选的模型。高负载时
Auto可能把一个难任务路由到比你想要的更便宜的模型——重要时就固定一个具名模型。
容易踩的坑
- 脏 working tree 下就让 Composer 或 Agent 模式跑。出问题时分不清是 Cursor 改的还是你改的。先 commit。
- 不加
.cursorignore。索引node_modules又慢又给上下文塞无关文件。 - 初次索引卡几个小时还不去看原因(索引一直跑不完)。
- 另一个窗口改了文件,Cursor 还拿着旧版本去 Apply(IDE 状态不同步)。
- 项目级、workspace、用户级规则文件互相叠加产生静默冲突,表现是「指令被忽略」、不报错(Cursor 配置冲突)。
- 一行小改也用 Composer。开销过大,审 diff 比改本身还久,用 Inline 编辑就行。
怎么复用这套流程
- 准备一份跨项目复用的
.cursorignore模板:node_modules/、dist/、*.log、大数据文件、secrets。 - 加一个项目规则文件(现行 Cursor 用
.cursor/rules/)写团队编码约定。Cursor 会把它当作每次 AI 请求的常驻上下文来读。 - 常用 Inline 编辑 prompt 存片段:“改成 async/await”、“加类型”、“抽到 helper”。
- 大版本更新后重测面板。Cursor 迭代很快——Composer 2.5 和 Agents 窗口都是 2026 年才落地的——键位偶尔会变。
FAQ
- Cursor 跟 VS Code 差距够大吗,值得换?: 每天写代码的话,光这五个 AI 面板就值。剩下的就是 VS Code,你原有的扩展、主题、键位都会在首次启动的导入里带过来。
- 跟 Claude Code、Codex 比呢?: Cursor 是编辑器优先;Claude Code 和 Codex 是 agent 优先(终端)。Cursor 赢在 IDE 工作流和 Tab 补全,另两个赢在不动手的长任务运行。详见 Cursor vs Claude Code。
- 必须付费吗?: 不必——免费的 Hobby 档足够把每个面板学会。但每天用很快撞到 Tab 和 Agent 上限,每月 20 美元的 Pro(截至 2026 年 6 月)一般一周内就值回。
- 新手该用哪个模型?: 从
Auto开始。它会路由到 Composer 2.5 和更便宜的模型,大多数 inline 编辑和重构都处理得不错。只在真正难的任务上才切到Claude Opus 4.7或GPT-5.5。 - Composer 和 Agent 模式有什么区别?: Composer 改多个文件,给你一份 diff 让你确认。Agent 模式是去掉逐步确认的 Composer——它还会跑终端命令、读输出、自己修错,直到任务做完。Agent 模式只在已提交、干净的仓库上用。
- 离线能用吗?: 编辑器能用,AI 功能需要联网。代码库索引本身在本地。