这篇讲什么
Cursor 自称”带 AI 的 VS Code”，但真正的学习曲线在”什么时候用哪个 AI 面板”：Tab 补全、Inline 编辑、Composer、Chat、Agent 各有甜蜜区和失败模式。这篇讲安装、第一次索引、4 次真实编辑——每个 AI 面板各一次——一小时后你就知道该按哪个键。
这篇适合谁看
想把 AI 留在编辑器里、而不是放在单独 chat 标签的开发者。从纯 VS Code 或 JetBrains 切过来基本无摩擦。想要更完整的 30 分钟流程（Inline vs Composer vs Chat、索引、@Files、回滚），先看Cursor 新手怎么开始——30 分钟跑通完整工作流。
什么时候适合用
你更想留在 IDE，不想用命令行 agent，还想把补全、跨文件编辑、Q&A 集中在一个地方。如果只是偶尔想用聊天帮忙写代码、并不想换编辑器，先对比一下 Gemini 写代码的工作流。
开始前准备
- 拿一个真仓库测试——不要新建一个空
npm create。Cursor 的价值在规模上体现。 - 知道项目约定：lint 规则、formatter、test 命令。Cursor 在干净基线上效果更好。
- 第一次 AI 编辑选一个低风险小任务，要可回滚。
- 决定用模型 API key（Cursor Pro）还是 Cursor 自带额度登录。
具体步骤
- cursor.com 安装。首次启动会问要不要导入 VS Code 设置——接受；导入不破坏原配置。
- 打开项目让它索引（看仓库大小 30 秒到几分钟）。如果是陌生仓库，等索引时可以在 Chat 里跑一遍让 AI 帮你做代码库导览的工作流。首次索引前加
.cursorignore排除node_modules、构建产物、大数据文件。 - 先试 Tab 补全。打函数签名、停一下、接受建议。Tab 是风险最低的 AI 面板，也是你一天用 100 次的那个。
- 试 Inline 编辑（macOS 上 Cmd-K，其他平台 Ctrl-K）。选一个函数、按快捷键、描述改动（“改成 async/await，保留错误处理”）。先想清楚什么时候用 agent、什么时候用自动补全，免得一行小改也开 Composer。
- Composer 用于跨文件编辑（Cmd-I）。任务用 2-3 句话描述、文件范围要明确：“在
src/api/把所有request.json()改成await request.json()。不要碰测试。“每个 diff 接受前都审。 - Chat（Cmd-L）用于讲解和探索。Chat 默认不改代码——它回答、你决定怎么应用。
第一次实操怎么跑
- 选一个小且孤立的任务：跨几个文件重命名变量、补 prop 类型、给一个模块加 JSDoc。可回滚、低风险。
- 一种做法用 Inline 编辑，另一种用 Composer。对比体验。
- 标哪个面板适合哪种任务。规律稳定：单函数改 → Inline；跨文件改 → Composer；“为什么这段代码这样”→ Chat；“补下一行”→ Tab。
- AI 编辑之间提交。每一步独立 commit，回滚更容易。
完成后检查
- 每个 Composer diff 都审。Cursor 偶尔会动你没想动的文件，拒掉那些 hunk。
- 跨文件编辑后跑全套测试。Cursor 抓类型错，不抓行为回退。
- 确认
.cursorignore真的排除了你想排除的。索引隐私数据或构建产物又慢又有隐私风险。 - 确认在用的是你选的模型。Cursor 偶尔在高负载时降级到更便宜的模型。
怎么复用这套流程
- 准备一份跨项目复用的
.cursorignore模板：node_modules/、dist/、*.log、大数据文件、secrets。 - 加
.cursorrules（或现行等价）写团队编码约定。Cursor 当系统上下文读。 - 常用 Inline 编辑 prompt 存片段（“改成 async/await”、“加类型”、“抽到 helper”）。
- 季度复测面板。Cursor 新功能很快，键位会变。
建议的操作流程
Tab 用于补全 → Inline 单函数 → Composer 跨文件（范围明确）→ Chat 用于讲解和代码考古 → 面板之间提交。
容易踩的坑
- 脏 working tree 下用 Composer 不管。出问题时分不清是 Cursor 改的还是你改的。
- 不加
.cursorignore。索引node_modules又慢又给上下文塞无关文件。 - 初次索引卡几个小时还不去看原因（索引一直跑不完）。
- 另一个窗口改了文件，Cursor 还拿着旧版本去 Apply（IDE 状态不同步）。
- 项目级、workspace、用户级
.cursorrules互相冲突，表现是「指令被忽略」，不会报错（Cursor 配置冲突）。 - 一行小改也用 Composer。开销过大，审 diff 比改本身还久。
FAQ
- Cursor 跟 VS Code 差距够大吗，值得换？: 每天写代码的话，光 AI 面板就值。剩下的就是带熟悉键位的 VS Code。
- 跟 Claude Code、Codex 比呢？: Cursor 是编辑器优先的 AI；Claude Code 和 Codex 是 agent 优先。Cursor 赢在 IDE 工作流，另两个赢在不动手任务运行。
- 必须付费吗？: 免费够评估。每天用很快到上限，一周内 Pro 就值回。
- 离线能用吗？: 编辑器能用，AI 功能需要网。索引在本地。