Cursor 不是”VS Code + ChatGPT”，它把 AI 编辑深度做进了文件操作。这篇带你跑通最少必要的工作流。
安装与第一次打开
- 官网下载（基于 VS Code 分支，扩展可复用）
- 登录后选定一个模型——日常用 Claude Sonnet 性价比最高
- 打开你已有的项目目录
三个核心操作
Inline edit（Cmd + K）
光标停在代码块上，按 Cmd + K（Mac）/ Ctrl + K（Win），输入”加注释”、“改成 TypeScript”等。只改这一段。
Composer（Cmd + I）
打开一个对话面板。在这里跨文件和 AI 协作：“在 routes 下新增一个 user.ts，参考 auth.ts 的结构”。Composer 会自动读多个文件、给出多文件改动建议。
Chat（Cmd + L）
只问不改的对话——理解一段代码、调试思路。
让 AI 真的看到你的项目
Cursor 索引项目需要时间，但索引完成 ≠ 它在回答时一定用到。两个显式注入手段：
- 在 Composer 里输入
@选具体文件 - 输入
@Codebase让它在整个仓库搜索
如果索引一直停在「Indexing…」，那是另一种失败模式——先看索引一直跑不完再决定是不是重启。
Apply 和回滚
AI 给出多文件改动 → 你点 Apply All 或逐个 Apply → 不满意按 Cmd + Z 或 直接 git restore。
不要在不熟的项目里”一键 Apply 几十个文件”，先看 diff。如果 Cursor 里看到的版本和磁盘上对不上（Apply 之后没把你最新的改动算进去），开一个新窗口重新加载——参考IDE 状态不同步。
适合做什么
- 重构一段函数 / 命名
- 新建相似文件
- 写测试用例
- 解释陌生代码
不适合做什么
- 大跨度架构设计
- 长链路调试（更适合 Claude Code）
- 多步可逆操作（git 状态会乱）
后续相关
实战例子
先拿一个具体小任务跑这套流程。比如：总结一份 PDF、重写一个落地页模块、审一个 PR、生成一组图片方向、调一个 prompt。输入要小到你能人工判断 AI 是否真的帮上忙。确认结果稳定后，再把同样模式扩展到完整文档、完整代码库或完整素材批次。
什么时候必须人工再复核一遍
- 输出要公开发布、发给客户、写进代码，或用于钱相关决策。
- 答案里有事实判断、法律 / 医疗 / 金融含义、隐私数据，或品牌敏感表达。
- 工具改了文件、设置、权限、账单、部署，或任何不容易撤销的东西。
- 你无法不用”相信模型”来解释最终结果为什么正确。
可直接复制的 Prompt
我想把这套流程用于一个真实任务。
目标：
- [写清楚你想得到什么结果]
上下文：
- 使用工具：[ChatGPT / Claude / Gemini / Cursor / Codex / 其它]
- 输入资料：[粘贴或上传文件、笔记、链接、截图]
- 限制条件：[语气、长度、格式、截止时间、受众、隐私限制]
请做三件事：
1. 先用你自己的话复述任务，并列出缺失信息。
2. 只基于我提供的上下文产出第一版。
3. 附一个简短检查清单，让我在使用前能验证结果。详细实操流程
- 先用最小的真实输入开始。不要用假文本测试；用一个真实文件、一个真实页面、一个真实 bug，或一份真实创意 brief。
- 在同一条消息里给工具目标、输入材料和好答案标准，避免模型优化错方向。
- 任务会影响代码、公开内容、钱、账号或品牌语气时，先让它出计划，不要直接要最终结果。
- 跑第一轮后人工检查：缺了哪些上下文、有没有事实不确定、格式有没有跑偏、模型有没有越权发挥。
- 修改时给具体反馈，不要只说”再好一点”。明确哪些保留、哪些删除、下一版要达到什么标准。
- 把最终 prompt、输入结构和检查清单保存成模板，下次同类任务直接复用。
常见的翻车情况
- 输出很空泛：加入真实资料，并指定更严格的输出格式。
- 工具编造事实：要求它区分”来自资料的确认信息”和”推断”，删掉无来源内容。
- 答案太长：先让它完整输出，再要求压缩到目标长度。
- 文字看起来专业但实际不对：按原始资料核对，不要按语气自信程度判断。
- 第二轮开始越改越乱：用修正后的上下文和上一版最佳结果重新开一轮。
FAQ
Q：Inline edit、Composer、Chat 三者怎么选？ A：只改一段代码用 Inline edit（Cmd + K）——速度快、回滚便宜。跨文件改用 Composer（Cmd + I）——多文件 diff 视图能一眼看清楚。只问不改、不想动代码（理解一段代码、调试思路）用 Chat（Cmd + L）。
Q：第一次索引要等多久？
A：跟仓库大小有关，常见 30 秒到 5 分钟。索引前一定加 .cursorignore（排除 node_modules、构建产物、大数据文件）——不然索引会包含一堆噪声，AI 会引用根本不该看的文件。
Q：Apply 之后怎么回滚？
A：Composer 每次 Apply 都进 git，最稳的回滚是 git checkout <file> 或 git reset。Inline edit 用 Cmd + Z 撤一步即可。重要的是动 Cursor 前 git status 干净，否则混在已有改动里就难拆。
Q：模型 API key 和 Cursor Pro 自带额度选哪个？ A：每月超 100 美元 API 用量的重度用户用自己的 key 通常更便宜；普通用户 Cursor Pro 自带额度（含 Claude / GPT 调用）省事很多。混合方案：日常用 Pro 额度，跑长任务时切自己的 key。