Appearance
界面与基本操作
Cursor 是基于 VS Code 构建的，如果你用过 VS Code，大多数快捷键和操作习惯都可以直接沿用。这页重点说 Cursor 自己加的几个核心功能区，以及它们对应的使用场景。
三个主要入口
Chat 面板（Cmd+L / Ctrl+L）
打开右侧的对话窗口。用于和 AI 聊代码、问问题、理解逻辑，不直接修改文件。适合在你还没决定怎么改的时候先聊清楚思路，或者想让 AI 解释一段代码的意思。
Chat 支持多轮对话，你可以在同一个 Chat 里一直聊，AI 会记住上下文。如果你发现聊题跑偏了，可以开一个新的 Chat 重置上下文。
Agent 面板（Cmd+I / Ctrl+I）
打开 Agent（也叫 Composer）面板，AI 会直接操作文件：创建、修改、删除。这是 Vibe Coding 最常用的入口。你描述任务，它执行，执行结果会直接反映在文件里。
Agent 面板里也有三种子模式（Ask / Edit / Agent），下一页会详细讲。大部分时候用 Agent 模式就够了。
内联补全（直接在编辑器里打代码）
你在编辑器里打字时，Cursor 会自动给出补全建议，按 Tab 接受，按 Esc 拒绝。这个用法和 GitHub Copilot 类似，适合你知道要写什么、只是让 AI 帮你补细节的场景。比如你开始写一个函数签名，它会补全函数体；你写了一半的 if 判断，它会补全另一半。
界面布局
打开 Cursor 后，你会看到和 VS Code 几乎相同的布局，加上几个 Cursor 特有的区域：
- 左侧文件树：和 VS Code 一样，项目的文件结构
- 中间编辑区：写代码的地方，内联补全在这里触发
- 右侧 Chat 面板：
Cmd+L打开，纯对话不改文件 - 底部浮动框 / 覆盖层：
Cmd+I打开 Agent/Composer，这是改代码的主要入口 - 底部状态栏：显示当前模型、token 用量等
关于上下文（Context）
AI 能看到什么，决定了它生成的质量。这是 Cursor 里最值得认真对待的概念。
默认情况下，Cursor 会自动引入一些上下文：当前打开的文件、最近编辑的文件、部分项目结构。但它不会自动读完项目里所有代码。
手动指定上下文用 @ 符号：
@文件名：把某个文件加入上下文（最常用）@文件夹：加入某个目录里的所有文件@web：让 AI 实时搜索网络@docs：引用你配置的文档（比如某个库的官方文档）@git：引用 git 历史或 diff
项目越大，越需要主动控制上下文。不要把整个项目都塞进去——上下文窗口有大小限制，内容太多会让 AI 稀释注意力，反而降低质量。对于复杂任务，宁愿多开几次对话，每次给精准的上下文。
Diff 视图
AI 修改文件后，Cursor 会显示修改前后的对比（diff 视图）。绿色是新增，红色是删除。你可以：
- 接受全部修改（Accept All）
- 逐块接受（Accept，在每个改动块旁边）
- 拒绝全部
不要养成直接点"全部接受"的习惯。AI 有时候会做超出预期的修改，比如顺手重构了你不想改的部分。花 10 秒扫一眼 diff，确认改动范围在预期内。
常用快捷键
| 操作 | Mac | Windows/Linux |
|---|---|---|
| 打开 Chat | Cmd+L | Ctrl+L |
| 打开 Agent/Composer | Cmd+I | Ctrl+I |
| 接受内联补全 | Tab | Tab |
| 拒绝内联补全 | Esc | Esc |
| 接受 AI 全部修改 | Cmd+Y | Ctrl+Y |
| 拒绝 AI 全部修改 | Cmd+N | Ctrl+N |
| 命令面板 | Cmd+Shift+P | Ctrl+Shift+P |
| 快速打开文件 | Cmd+P | Ctrl+P |
| 搜索项目内容 | Cmd+Shift+F | Ctrl+Shift+F |
VS Code 的快捷键全部通用，上面列的是 Cursor 特有或最常用的。
常见使用误区
把 Chat 和 Agent 搞混
Chat 只聊，不改文件。Agent 才会真的修改你的代码。如果你在 Chat 里问"帮我把这个函数改成异步的"，它只会告诉你怎么改，不会真的动文件。要改代码，得用 Cmd+I 打开 Agent。
上下文给得太少
AI 看不到相关文件时，会基于猜测生成代码，通常和你的项目现有结构不符。如果你发现 AI 总是"从零开始"而不是基于你已有的代码改，很可能是上下文没给对。
不看 diff 就接受
在你学会快速判断 diff 之前，每次修改后都花 10 秒扫一眼，确认改的范围在预期内。一旦你接受了不对的修改，用 Cmd+Z 撤销，或者用 git 恢复。
下一页是 三种模式选择，讲什么时候用 Ask、什么时候用 Edit、什么时候用 Agent，以及如何在三种模式之间切换。