Cursor 新手指南:从安装到第一次真实编辑

Cursor 真正的学习曲线不是安装,而是搞清楚什么时候用 Tab、Inline 编辑(Cmd-K)、Composer(Cmd-I)、Chat(Cmd-L)还是 Agent 模式。五个面板、四次真实编辑,含 2026 年 6 月最新价格与模型。

一句话总结

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)干什么什么时候用
TabTab预测你下一步编辑,常常跨多行、甚至跳到下一处正打到一半、下一个 token 很明显
Inline 编辑Cmd-K / Ctrl-K用提示框就地重写选中的代码块只改一个函数或一个块
ComposerCmd-I / Ctrl-I一次改多个文件,再给你一份可逐块审阅的统一 diff改动跨好几个文件、你想逐 hunk 审
ChatCmd-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 和更便宜的模型)应付大多数编辑都够;需要时再从选择器里按单次请求切到具名的旗舰模型。

具体步骤

  1. cursor.com 安装。首次启动会问要不要导入 VS Code 的设置、扩展和键位——接受;导入不破坏原配置,也不动你原来的 VS Code。
  2. 打开项目,它会自动开始索引(看仓库大小,30 秒到几分钟)——它在本地建一个 embedding 索引,好把相关文件拉进上下文。首次索引就加好 .cursorignore,排除 node_modules、构建产物、大数据文件。如果是陌生仓库,等索引时可以在 Chat 里跑一遍让 AI 帮你做代码库导览的工作流
  3. 打开模型选择器(任意 AI 面板右下角的模型名)。一开始保持 Auto——Auto 在成本和能力之间平衡,和 Composer 2.5 共用一个用量池但更便宜。难一点的 agent 任务再固定到 Claude Sonnet 4.6Opus 4.7,终端密集的活用 GPT-5.5,快速的 inline 编辑用 Composer 2.5
  4. 先试 Tab 补全。打函数签名、停一下、按 Tab 接受建议。Tab 是风险最低的面板,也是你一天用 100 次的那个。它不只补全这一行,常常还预测你在文件别处的下一步编辑。
  5. Inline 编辑Cmd-K / Ctrl-K)。选一个函数、按快捷键、描述改动:“改成 async/await,保留错误处理。“先想清楚什么时候用 agent、什么时候用自动补全,免得一行小改也开 Composer。
  6. ComposerCmd-I / Ctrl-I)做跨文件编辑。任务用两三句话描述、文件范围要明确:“在 src/api/ 把每一处 request.json() 调用改成 await request.json()。不要碰测试。“每个 diff 接受前都逐块审。
  7. ChatCmd-L / Ctrl-L)做讲解和探索。Chat 默认不改代码——它回答、你决定怎么应用。选中有问题的代码按 Cmd-Shift-L / Ctrl-Shift-L,能把选区直接塞进 Chat。

第一次实操怎么跑

  1. 选一个小且孤立的任务:跨几个文件重命名变量、补 prop 类型、给一个模块加 JSDoc。可回滚、低风险。
  2. 一种做法用 Inline 编辑,另一种用 Composer,直接对比体验。
  3. 标哪个面板适合哪种任务。规律稳定:单函数改 → Inline;跨文件改 → Composer;“为什么这段代码这样?”→ Chat;“补完这一行”→ Tab。
  4. AI 编辑之间提交。每一步独立 commit,回滚更容易,也能用 git diff 看清 Cursor 到底动了什么。

Cursor 价格(截至 2026 年 6 月)

付钱之前,你完全可以在免费档把每个面板都学会。以下是 cursor.com/pricing 上当前的个人和团队套餐:

套餐价格(美元/月)年付适合谁
Hobby免费评估用;Tab 补全和 Agent 请求有限,免信用卡
Pro$20年付约合 $16/月个人每天用;Agent 上限更高、$20 旗舰模型额度、MCP 和云端 agent
Pro+$60agent 用量更重、额度更多
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.7GPT-5.5
  • Composer 和 Agent 模式有什么区别?: Composer 改多个文件,给你一份 diff 让你确认。Agent 模式是去掉逐步确认的 Composer——它还会跑终端命令、读输出、自己修错,直到任务做完。Agent 模式只在已提交、干净的仓库上用。
  • 离线能用吗?: 编辑器能用,AI 功能需要联网。代码库索引本身在本地。

相关阅读

标签: #AI 编程 #教程 #Cursor