Cursor 是一款基于 VS Code 的 fork 构建的 AI 代码编辑器，设计目标是让 AI 辅助嵌入编辑流程之内，而不是置身其旁。你无需切到单独的聊天窗口去起草代码：输入时即可获得行内补全，还有一个能规划并执行跨文件修改的 Agent，每一步都由你把关。如果你想先看一篇更全面的实操介绍，我们的 Cursor 全面介绍对这款编辑器有更深入的讲解。本文聚焦各主要 AI 功能如何配合，以及你的第一次会话大致是什么样子。
Cursor 适合谁
如果你符合以下大部分条件，Cursor 会是不错的选择：
- 你要花实实在在的时间编写或维护代码，希望 AI 内嵌于这项工作，而非外挂式附加。
- 你希望 AI 辅助能考虑项目上下文——相关文件、代码规范、项目结构——而不只是当前打开的文件。
- 你已经在用 VS Code，想保留现有的扩展、主题和快捷键配置。安装时会提供导入选项。
- 你更愿意审查具体的 diff，而不是从聊天机器人里复制粘贴建议。
如果你很少改代码，或者你的环境禁止把代码发送给云端模型，那 Cursor 就不太合适——这条边界下文还会展开。
与传统编辑器的工作流差异
传统编辑器（如果有 AI）把 AI 当作被动助手。Cursor 则把它当作一个有两种模式的协作者：Tab 负责即时的编辑操作，Agent 负责被委派的跨文件任务，涵盖代码库搜索以及需要你批准后才会运行的终端命令。无论哪种模式，你都坐在审查者的位置：改动以 diff 的形式出现，由你接受、拒绝或进一步调整，反馈闭环依靠你自己的测试和构建，而不是模型的自信判断。
Agent 与 Tab 速览
这两个功能是互补关系，不是竞争关系。具体能力和模型行为可能因套餐、账号和当前文档而异，但两者的交互模式始终不同：
| 维度 | Tab | Agent |
|---|---|---|
| 触发时机 | 你输入代码时 | 你给它分配任务时 |
| 典型范围 | 当前这次编辑，包括多行建议 | 跨文件修改、代码库搜索、终端命令 |
| 交互方式 | 行内建议，可接受或忽略 | 先对话式提出请求，再审查它做的修改 |
| 你的角色 | 逐键引导方向 | 说明目标结果、审查 diff、迭代调整 |
| 适合场景 | 重复性编辑、就地重构、样板代码 | 跨多个文件的多步骤任务 |
一个实用的判断标准：如果你能用一句话说清改哪里、改什么，那就是 Tab 的地盘；如果需要先有个计划、涉及多个文件，或者要先做搜索，就用 Agent。
首次使用的工作流
以下步骤与官方快速入门一致；我们的入门指南沿同样路径有更详细的讲解。
- 安装并登录。 AI 功能需要 Cursor 账号。如出现提示，导入你的 VS Code 扩展、主题、快捷键配置和设置。
- 打开一个你熟悉的小项目，该项目受版本控制，且工作区干净无未提交改动。
- 先用 Tab 热身。 做一个重复性的编辑——比如重命名一个多处使用的变量，或者复制一个小函数再改一改。按 Tab 接受建议，按 Escape 忽略，并留意它何时提出多行修改。
- 给 Agent 一个范围明确的任务。 例如：“给注册表单加上输入验证，并更新相关测试。”如果你想先看到思路再让改动落地，可以让它先列出计划。
- 审查全部内容。 逐个阅读 diff，运行你的测试或构建，然后按文件决定保留还是回退。
- 调优这个循环。 如果结果缺少上下文，明确点名具体文件。对于反复出现的代码规范，可以通过项目规则写入固定指令——参见入门规则。
限制与边界
在依赖它之前，先设定合理的预期：
- 使用额度因套餐而异且可能调整，重度日常 Agent 使用请以你当前套餐实际允许的为准。本文任何内容都不应被理解为可无限量使用的保证。
- 可用模型因账号和地区而异，且会随时间变化；请以应用内显示为准，不要默认某个特定模型一定可用。
- Agent 的质量取决于它获得的上下文。在大型或不寻常的代码库上，它可能误判结构——范围明确的任务比大而泛的任务效果更好。
- Tab 和 Agent 都可能生成看似合理实则错误的代码。人工审查不可省略。
隐私与安全边界
AI 功能的运作方式是把相关代码和上下文发送给模型以生成结果——这是需要理解的核心取舍。在你的环境提供相关选项时，隐私模式等选项旨在防止你的数据被用于训练。在团队版和企业版中，管理员可能可以控制数据处理设置和默认值，地区性要求也可能适用。在让 Cursor 接触敏感或专有代码之前，请查看你可用的隐私设置以及所在组织的政策，并在官方文档中确认当前行为，因为默认值和选项会不断演变。
验证与恢复
把每一次输出都当作待审的提案。验证与恢复有三层：
- 接受前审查 diff，并在 Agent 的审查界面按单条更改拒绝，而不是事后去拆解一堆改动。
- 使用检查点。 在可用的位置，Agent 会创建还原点；当一连串编辑走偏时，你可以把工作区回滚到还原点。
- 把 Git 当作最终事实依据。 委派任务前先提交或 stash，自己运行
git diff查看，绝不盲目批准终端命令——逐条阅读，拿不准就手动执行。
常见问题排查
- Agent 做出含糊或错误的修改。 重新描述任务，写明目标文件和预期行为，把它拆成更小的步骤，并让它针对具体文件而不是整个仓库。
- Agent 重复犯同一个错误。 把确切的报错或失败的测试输出贴进对话；如果反复出现，就把相关规范写进规则固定下来。
- Tab 建议没有出现。 确认设置中 Tab 已启用、你已登录，且你的环境支持它——行为可能因模型和配置而异。
- 实际行为与本文不符。 功能会不断变化；任何时点的快照——包括本文——都以当前官方文档为准。
常见问题（FAQ）
Cursor 是编辑器还是扩展？
它是一款独立编辑器，基于 VS Code 的 fork 构建。引导流程可以导入你现有的扩展、主题、快捷键配置和设置，因此大部分 VS Code 使用习惯都能延续。但不保证与每一个具体扩展都兼容——请逐一验证你的工作流所依赖的扩展。
Tab 和 Agent 使用同样的 AI 模型吗？
它们是两个独立的功能，交互模式不同，尽管都以 AI 为基础，模型选择可能有重叠。哪些模型可用取决于你的套餐、账号和地区，并会随时间变化——请查看应用内的模型列表，了解当前适用于你的选项。
Cursor 会用我的代码训练吗？
各项功能会把相关代码和上下文发送给模型来生成结果。隐私模式在启用且你的套餐提供该选项时，设计目的是阻止你的数据被用于训练。管理员设置和地区要求可能影响适用于你的选项，请以最新的隐私文档为准。
能否在不对项目造成风险的情况下试用？
可以。在全新的分支或一次性克隆上操作，分配小而明确的任务，审查每一个 diff，不要笼统地批准所有命令。有了按条拒绝、可用的检查点，再加上 Git 本身，你有多重手段可以干净地撤销一次实验。