Cursor 将大量功能集成在一款编辑器中——自动补全、内联编辑、具备上下文感知的对话、能执行多步任务的 Agent,甚至还有在云端运行的 agent。学它最快的方式不是死记按钮，而是把每个功能对应到你实际要做的事情上。本指南按使用意图对 Cursor 的核心功能分组：理解代码、编写与编辑代码、委托更大的改动，以及验证结果。凡是行为可能因版本、模型、套餐或管理员设置而异的地方，我们都会标注——而 Cursor 的官方文档始终是了解最新细节的权威来源。
按任务选择功能
选能完成任务的最小工具。更大的工具更强力，但也需要更多审查。
| 你的意图 | 用什么 | 需要知道的边界 |
|---|---|---|
| 输入时补全一行或做小改动 | Tab | 仅提供建议——不会回答问题或执行任务 |
| 就地重写某段代码 | 内联编辑(通常是 Cmd/Ctrl+K) | 局部、定向修改——不能跨文件执行 |
| 问“这是怎么工作的？” | 开启代码库上下文的 Ask 模式对话 | 只给指导，不做修改 |
| 规划并执行多步改动 | Agent | 会编辑文件并可能运行命令——务必逐项审查 |
| 直观检查 Web 应用的行为 | 带浏览器工具的 Agent | 可用性因版本而异；不能替代真实测试 |
| 你离开时委托一个长任务 | 云端 Agent | 远程运行；合并前审查生成的分支或 PR |
如果你还在纠结 Cursor 是否适合你的工作流，我们关于 Cursor 的概览更全面地介绍了这款编辑器。
阅读与理解代码库
当你的目标是理解代码时，使用开启代码库上下文的 Ask 模式对话。Cursor 可以在已索引的仓库中搜索，并引用答案来源的文件，让你能验证答案而不是盲信。用 @ 提及把特定文件、文件夹或文档固定进对话——这是解决含糊、泛泛回答的最有效办法。
决策原则：如果此刻你不希望它直接动手改代码，你需要的是 Ask 模式，而不是 Agent。注意，代码库索引可能需要先完成，答案才有扎实依据；索引行为取决于你的设置和工作区大小。
日常编写与编辑
Tab 负责流畅输入：在你打字时给出补全建议，包括多行编辑，并常常顺带指出下一个值得修改的位置。按 Tab 接受，按 Escape 忽略。默认快捷键可以自定义，建议质量随所选模型和你的设置而变化。
当你明确知道要改什么、改哪里时，用内联编辑。选中代码，调出内联编辑快捷键，描述改动，然后审查 diff。适合的场景：在函数内重命名变量、添加守卫语句、改写循环。如果改动涉及多个文件或需要运行任何命令，就该升级到 Agent。
用 Agent 处理多步任务
Agent 是 Cursor 的委托工具。给它一个目标，它就能规划、编辑文件，并提出用于构建、测试或运行项目的终端命令。命令是自动执行还是等待你批准，取决于你的自动运行设置——首次使用前先检查这些设置。
一个可复现的入门示例：打开一个小项目，输入提示词“为注册表单添加输入校验，然后运行现有的测试套件并总结所有失败项”。接着依次过三个检查点：
- 审查计划 —— 在改动落地前确认范围符合你的意图。
- 审查每个 diff —— 逐文件接受改动，不要批量接受。
- 审查每条命令 —— 尤其是任何涉及删除、安装或访问网络的命令。
初期任务要窄。“修复这个失败的测试”远比“改进代码库”可靠。
浏览器检查与云端工作流
较新的版本加入了浏览器工具，让 Agent 可以打开运行中的 Web 应用、点击页面并检查结果，从而发现自己的视觉或功能错误。可用性和行为因版本和平台而异，因此把它当作便捷的冒烟检查——而不是真实测试套件的替代品。
云端 Agent 在此基础上更进一步：任务在隔离的远程环境中的独立分支上运行，完成后可生成 diff 或拉取请求。这适合较长或自包含的工作；其可用性取决于套餐、设置以及该功能是否已为你的账户启用。原则不变——没有人读过 diff,任何东西都不该合并。
安全的起步任务与验证清单
如果你在全新环境上手，我们的入门指南会讲解基础。在编辑器内做首批任务时，从犯错代价低的地方开始：
- 对你已经理解的文件用 Ask 模式提问，然后核对它引用的文件
- 先用 Tab 正常打字半小时，再碰其他功能
- 让 Agent 为单个文件添加注释或文档
- 让它为现有函数写一个单元测试，然后你自己运行测试
- 用范围明确的提示词修复一个已知的失败测试
凡是 Agent 动过的东西，都要过这份验证清单：
- 接受之前读完整个 diff——看起来合理的代码仍可能是错的
- 自己运行构建和测试；不要只依赖 Agent 的报告
- 扫一遍终端历史，看有没有你没预料到的命令
- 每个阶段被接受后就提交或存档检查点，让自己始终有退路
恢复手段是分层式的：拒绝未接受的改动，在功能可用时恢复到之前的检查点，最后退回到 git——无论任何工具做了什么，git 始终是你真正的真相来源。
限制、隐私与安全
要清楚四条边界。第一，上下文是有限的——特别大的仓库或未提交的改动可能无法被完整呈现，这就是手动 @ 提及重要的原因。第二，模型会生成看似合理的错误；Agent 可能信心满满地写出能编译但行为不对的代码。第三，命令以你的权限在你的机器上运行，因此审批设置是一道安全控制，不是走过场。第四，绝不要把密钥、凭据或 API key 粘贴进提示词。
关于隐私：Cursor 提供隐私模式(Privacy Mode),其设计目的是让你的代码和提示词不被用于训练模型；团队版和企业版管理员可以集中强制实施数据处理设置。确切行为取决于你的套餐和管理员配置——请以官方文档中的现行政策为准，不要自行假设。
快速排障
- Tab 建议很弱或没有： 检查设置中该功能是否已启用，并尝试更换所选模型。
- 对话回答太泛泛： 用
@提及添加具体文件，并确认索引已经完成。 - Agent 循环打转或跑偏： 停下它，把任务重新描述得更窄，并指向具体文件。
- 命令执行失败： 把错误输出贴回对话——Agent 能直接读到失败信息时效果最好。
- 行为和教程不一样： 功能和快捷键会随版本变化；重新查阅文档。
FAQ
什么时候该用 Tab,而不是内联编辑或 Agent?
输入时需要建议用 Tab;改动你能自己描述和定位的，用内联编辑；任务跨多个文件、需要运行命令或需要规划时，用 Agent。只有当更小的工具明显干不了这个活时才升级。
Agent 会不会不问就运行终端命令？
这取决于你的自动批准设置。默认情况下你应该预期有一个审查环节，但如果你开启自动运行，命令将不经确认直接执行——开启前请仔细阅读相关设置，尤其是在涉及敏感数据的项目上。
我的代码会被用来训练模型吗？
在启用隐私模式的情况下，Cursor 的设计不会把你的代码或提示词用于训练。团队版和企业版管理员可以实施额外的控制，具体条款因套餐而异——请根据你的账户类型核对当前文档。
云端 Agent 能在我电脑关机时工作吗？
可以——这正是远程执行的意义所在。Agent 在隔离的云端环境中、在自己的分支上运行，你稍后以 diff 或拉取请求的形式收取结果。你仍需要自己审查并合并输出，可用性取决于你的套餐和设置。