# Cursor AI 教程：从安装到第一次审过的修改

> 开始用 Cursor，先从 [cursor.com/download](https://cursor.com/download) 下载并安装，登录你的账号后用 File > Open Folder 打开项目文件夹。在 Windows 上按 Ctrl+I，Mac 上按 Cmd+I，打开 Agent，请它做一处小修改。Agent 一边做一边保存改动，所以要读一遍 diff，把你不想要的改动拒掉。

Mindket 编辑部 · 发布于 2026-11-05 · 更新于 2026-11-05 · https://mindket.com/cn/learn/vibe-coding/cursor-tutorial

## 要点

- 第一个请求只让它读不让它改，在任何一行代码变动之前先摸清结构。
- 每走好一步就提交到 Git，因为 Cursor 留的撤销记录只存在这台电脑上。
- 弄清项目运行需要哪些命令之前，命令审批一直开着。
- 同一句纠正打过两次，就把它写成一条规则。

## 安装 Cursor，打开项目文件夹

Cursor 是一个代码编辑器，也就是用来阅读和修改程序文件的应用，里面内置了一个 AI 智能体。智能体是能先规划任务、再动手改你的文件把它完成的 AI。在 Cursor 里它就叫 Agent。你用平常的话提出要求，Agent 会找到相关文件，修改它们，还能运行命令检查结果。

你需要一个 Cursor 账号，在 [cursor.com](https://cursor.com) 就能注册，以及一台装着 Windows 10 及以上、macOS 12 Monterey 及以上或 Linux 的电脑。苹果芯片和英特尔芯片的 Mac 都支持。安装几分钟就能完成。

智能体也可以在网页 [cursor.com/agents](https://cursor.com/agents) 上运行，这项功能叫 Cloud Agents。这一课只用桌面应用，每一处文件改动都在你自己的电脑上看得到。

1. **下载。**打开 [cursor.com/download](https://cursor.com/download)，点对应你操作系统的下载按钮。Windows 得到的是 .exe 安装程序，macOS 是 .dmg 文件。
2. **安装。**Mac 上把 Cursor 拖进 **Applications** 文件夹。Windows 上运行安装程序，按提示走。Linux 上用 apt 或 dnf 安装，或者直接运行便携的 AppImage 文件。
3. **登录。**打开 Cursor，出现提示时用你的 Cursor 账号登录。
4. **打开文件夹。**选择 **File** > **Open Folder**，挑出放项目的文件夹。第一次试，新建一个空文件夹打开就行。
5. **打开 Agent。**Windows 和 Linux 上按 Ctrl+I，Mac 上按 Cmd+I，Agent 面板就会出现在文件旁边。

> 在 Linux 上，Cursor 更推荐用 apt 和 dnf 软件包，而不是 AppImage。软件包会加上桌面图标、自动更新和命令行工具。

## 先请 Agent 讲解，再请它改一处

代码库就是一个项目全部文件的总和。面对一个不是你写的项目，先提一个只读不改的请求。Cursor 的快速入门一开始用的就是下面两条提示词，原样照录。一条帮你摸清项目，另一条请它出主意，并让 Agent 等你选定之后再动手。

好的第一件活又小又稳，比如改一个标题的措辞，或者摆正一个没对齐的按钮。已经知道要改什么，就直接说，并描述你想看到的结果。Cursor 帮助中心举的例子是：“Add a dark mode toggle to the settings page.”

````text
Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes.

Suggest three small, safe improvements in this codebase. Explain the tradeoffs and wait for me to choose one.
````

- **指定文件。**在聊天框里输入 @，再接文件或文件夹的名字，告诉 Agent 去哪里找。它自己也会搜索代码库。
- **排队下一条。**Agent 忙着的时候，输入下一条指令按 Enter。当前任务结束后它会接着运行，排队的消息还能拖动调整顺序。
- **叫停。**点 **Stop**，让 Agent 在任务中途停下，再给它新方向，或者换个做法。
- **回答它的提问。**Agent 可能在任务中途问你问题。等你回答时，它会继续读文件、改文件，答案一到就用上。
- **发送选中的代码。**选中几行代码，Windows 和 Linux 上按 Ctrl+L，Mac 上按 Cmd+L，Agent 打开时输入框里就带着这几行。
- **在旁边问。**在聊天框里输入 /side，后面接你的问题，就会打开一个侧边聊天。它去查一个岔开的问题，不打断主对话。

**Cursor 给 Agent 加了什么**

1. **2025年10月7日** Plan Mode。Agent 先调研代码库、向你提问，写出一份可以修改的计划，然后才动手。
2. **2026年8月19日** /goal 和中途引导。/goal 给 Agent 一个长期目标，让它一直做到完成。任务进行中发出的消息，会在它下一次调用工具时送到。
3. **2026年8月27日** 不连仓库也能用 Cloud Agents。Cloud Agent 可以从零开始一个项目，不必先连接 GitHub。
4. **2026年10月6日** 远程查看本地智能体。在 Cursor 的 iOS 应用里，能看到电脑上正在运行的智能体，还能回复它们。

来源：[Cursor 博客：Plan Mode](https://cursor.com/blog/plan-mode) (2026-11-05 查阅)；[Cursor 更新日志](https://cursor.com/changelog/page/2) (2026-11-05 查阅)；[Cursor 更新日志](https://cursor.com/changelog) (2026-11-05 查阅)

## 审每一处修改，用检查点退回

Agent 一边工作一边应用修改，改动会立刻存到磁盘上。diff 是一种视图，逐个文件标出删掉的每一行和新加的每一行。Agent 做完后读一遍，把你没要求的改动拒掉。

然后请 Agent 运行你的项目已经在用的检查。检查是替你测试代码的命令，比如单元测试、类型检查、标出风格错误的 linter，或者本地构建。新建的空项目还没有这些。那就在浏览器里打开页面，自己点一遍，就像你检查 Lovable 应用那样。

Agent 自己也能看页面。它的浏览器工具会打开应用、点一遍，再截图确认视觉上的修改确实生效了。你可以请它对刚改过的地方用上这个工具。

检查点是 Agent 在较大改动之前保存的一份文件快照。Agent 走错了方向，就把鼠标移到之前的一条消息上，点 **Restore Checkpoint**。那之后 Agent 改过的每个文件都会恢复原样。恢复只针对文件，聊天里的消息仍然保留。

检查点存在你的电脑上，和 Git 分开。Git 是一种版本控制工具：它把项目每一次保存的状态记下来，叫作一次提交，以后可以回到其中任何一个。会话之内撤销 Agent 的工作用检查点，想长期保留的历史交给 Git。

想要第二意见，就在 Agent 输入框里输入 /agent-review。它会对你本地的改动单独做一次代码审查。Quick 审查快，适合小改动。Deep 审查慢一些、花费也更高，适合涉及安全的代码或大规模重写。

> 自动重载是一项设置，文件一变就重启正在运行的应用，它会把这个顺序倒过来。开着它，Agent 的修改可能在你读到之前就已经跑起来了。

## 选好模式，决定哪些操作不用问你

在 Agent 输入框里按 Shift+Tab，可以在四种模式之间轮换，也可以从下拉菜单里选。每种模式都从全新的上下文开始，上下文就是一次对话的工作记忆。换任务时也最好新开一个聊天。

改动涉及好几个文件，或者需要先调研时，Plan 就派上用场了。Agent 不会马上写代码，而是先在代码库里找出相关文件，向你提问，写出一份详细计划，等你批准之后才动手。

有些操作从不询问。Agent 读文件、搜代码都不用批准，修改你文件夹里的文件也不问，配置文件例外，比如工作区设置。想让某个文件完全不被它碰到，就把它写进项目里的 .cursorignore 文件。它能上网的范围也很窄。默认设置下，Agent 的工具只会访问 GitHub、你给它的链接和网页搜索服务。

终端命令不一样。终端命令是你打给电脑的一条指令，比如安装一个软件包或启动应用，默认每一条都要等你批准。通过 MCP 接入的工具也要问，MCP 是把外部服务接到智能体上的一种标准方式：先问一次连接，之后每次调用都要问。

在 **Settings** > **Agents** > **Approvals & Execution** 里的 Run Modes，可以调整你会看到多少次询问。Allowlist 会不经询问直接运行你列出的操作。Auto-review 会立刻运行列出的调用，其余的 shell 命令尽量放进沙盒运行。沙盒是一个隔离的空间，命令在里面不能随意读取受保护的文件，也不能随意联网。剩下的交给分类器，一个逐条判断调用的小型 AI 模型。Run Everything 则全部直接运行，一次都不问。

Cursor 的 Run Modes 页面对中间这个选项说得很直白：“Auto-review is not a security boundary.”分类器可能放行一个你本来会拦下的调用。还在学的时候，保留这些询问，每条命令看清楚再点。

下载陌生人的项目时，还有一个默认设置要知道。工作区信任会用受限模式打开陌生文件夹，而它在 Cursor 里默认是关着的。Cursor 的安全页面建议，不信任的仓库用普通文本编辑器打开。

| 模式 | 最适合 | 会改文件吗 |
| --- | --- | --- |
| Agent | 做功能、修 bug、整理代码 | 会 |
| Ask | 弄懂代码，以及各部分怎么配合 | 不会，只读 |
| Plan | 较大的功能：先调研、提问，再写出计划 | 你批准计划之后才改 |
| Debug | 需要从运行中的应用里找证据的棘手 bug | 会 |

## 写下规则，免得一再重复

规则是 Agent 在一个项目的每次聊天里都会遵守的固定指令，比如新文件用哪种语言写。没有规则，同一句纠正你得一遍遍地打。从小处开始，Agent 同一个错误犯了不止一次，就加一条规则。

新建规则时，在 Windows 和 Linux 上按 Ctrl+Shift+P，Mac 上按 Cmd+Shift+P，打开命令面板，选 New Cursor Rule。给它起个名字，用 Markdown 写指令，这是一种纯文本格式，用短横线开头表示列表项。Cursor 会把文件存在项目里的 .cursor/rules/ 下，所以它跟着代码走。

类型设置决定规则什么时候生效：**Always Apply**、**Apply Intelligently**、**Apply to Specific Files** 或 **Apply Manually**。在项目最上层文件夹放一个普通的 AGENTS.md 文件也可以，Cursor 会自动读取。下面三行是为这一课写的一条入门规则，规则类型、文件匹配和旧 .cursorrules 文件的迁移，[Mindket 的 Cursor 规则指南](https://mindket.com/cn/blog/cursor-rules)讲得更细。每条规则控制在 500 行以内，太长就拆成几个各管一件事的文件。

规则只对 Agent 生效。Tab 补全，也就是你打字时冒出来的代码建议，不理会规则。Cursor 还会像读 AGENTS.md 一样，读取最上层文件夹里的 CLAUDE.md 文件，所以为别的智能体写的指令也能沿用。

````markdown
- Explain each change in one plain sentence before you make it
- Keep every page readable on a phone
- Ask before adding a new package
````

## Cursor 联合创始人和 Lee Robinson 怎样用 Agent

Cursor 联合创始人 Michael Truell 在 2026 年 1 月 20 日 [在 X 上](https://x.com/mntruell/status/2013636888242835810)发了团队总结的用法，同时引用了 Cursor 讲怎样和智能体协作的指南。先在 Plan 模式里做计划，按 Shift+Tab 就能切过去。让 Agent 自己搜代码，不要用 @ 把每个文件都标上。用测试当反馈回路。一次运行跑偏了，就撤回，把计划收紧，再跑一遍。

换成这一课的说法，最后那条就是一套简短的流程。在跑偏之前的那条消息上点 Restore Checkpoint，把计划里含糊的地方改清楚，再重新发送。同一个错误又出现时，就加一条规则，他的清单里也有这一条。

Lee Robinson 曾任 Cursor 副总裁，按他的 X 简介，现在在 SpaceX 做产品。他在 2025 年 12 月 31 日 [在 X 上](https://x.com/leerob/status/2006413745380114833)讲了自己的习惯。每个新功能，他都先在 Plan Mode 里做计划。

代码他要审三遍：Agent 写的时候看一遍，推送之前在编辑器里用智能体审查一遍，最后在拉取请求上让 Cursor 的 AI 审查工具 Bugbot 再看一遍。中间那一遍，就是这一课讲的 /agent-review 命令。下面是他自己 2026 年的课程，30 分钟讲完同一套流程：规划功能、修 bug、审查和测试代码。

> 跑偏了就：撤回 → 把计划收紧 → 重跑
>
> Michael Truell, Cursor 联合创始人，引文为译文, [X](https://x.com/mntruell/status/2013636888242835810) (2026-11-05 查阅)

[![Michael Truell（@mntruell）2026 年 1 月 20 日在 X 上分享 Cursor 用法：先做计划（Shift+Tab 进入 Plan Mode），让 Cursor 自己搜索，不要过度标注上下文，用测试当反馈回路，跑偏了就撤回、收紧计划、重跑](https://mindket.com/blog/shots/x-mntruell-cursor-tips.webp?v=97875af271b2)](https://x.com/mntruell/status/2013636888242835810)

Michael Truell 在 X 上，2026 年 1 月 20 日

[Cursor: coding agents tutorial (2026)](https://www.youtube.com/watch?v=kF2WQgk1LtY)

Lee Robinson 的 YouTube 频道 leerob，2026 年 4 月发布：一门用编程智能体做软件的课程，从规划新功能、修 bug，讲到审查和测试代码。

> X 官方嵌入卡片的截图，拍摄于 2026-11-05，时间为协调世界时（UTC）。X 用“Show more”截断了帖子后面的内容。点击截图可到 X 上打开原帖。

## 下一课：GitHub Copilot 的 agent 模式

继续之前，在 Cursor 里完整走一遍。打开一个空文件夹，请 Agent 按你在第一课写的简述做一个单页网站。读 diff，打开页面。再请它改一处，然后恢复改之前的检查点，看着文件变回去。

Copilot 把同样的习惯带进 VS Code，也就是微软的代码编辑器。[GitHub Copilot 这一课](https://mindket.com/cn/learn/vibe-coding/github-copilot-agent-mode)会在那里设置 agent 模式，还会讲一个在 GitHub 自己的服务器上工作、做完把改动交回给你审的智能体。

## 自测一下

1. Agent 改了三个文件，你想让它们全部回到上一条请求之前的样子，该点什么？

   A. Stop
   B. Ask
   C. Restore Checkpoint
   D. New Cursor Rule

   答案：C。 恢复检查点会把那条消息之后 Agent 改过的每个文件都还原，聊天记录保持不变。

2. 哪种模式回答关于代码的问题，却一个文件都不改？

   A. Ask
   B. Agent
   C. Debug

   答案：A。 Ask 模式只读，它讲解、探索，但从不改文件。

3. 在默认设置下，哪个操作要等你批准？

   A. 读取一个文件
   B. 搜索代码
   C. 修改文件夹里的一个页面
   D. 运行一条终端命令

   答案：D。 读取、搜索和大多数文件修改都直接进行，终端命令默认要先问你，除非你改了 Run Modes。

4. 用 New Cursor Rule 新建的规则存在哪里？

   A. 只存在你的 Cursor 账号里
   B. 项目里的 .cursor/rules/ 下
   C. diff 视图里
   D. 某个检查点里

   答案：B。 项目规则是 .cursor/rules/ 里的文件，跟着代码走，也能放进 Git。

## 常见问题

### Cursor 免费吗？

不付钱也能开始。注册账号不花钱，Free 套餐自带有限的用量。Agent 用得多了，就需要 [Cursor 价格页](https://cursor.com/help/account-and-billing/pricing)上的某个付费套餐。

### Cursor 和 VS Code 是一回事吗？

很接近，但不是。它沿用 VS Code 的默认快捷键，又为 AI 功能加了自己的快捷键，比如用 Ctrl+L 把选中的代码发给 Agent。VS Code 本身则是通过 GitHub Copilot 获得智能体。

### Cursor 里的 Agent 和 Ask 有什么区别？

Ask 只回答。你可以问它数据库连接是在哪里配置的，它不会动任何文件。Agent 也会回答，然后还会接着改文件、运行命令。

### .cursorrules 去哪了？

项目根目录下单独的 .cursorrules 文件是旧格式，将来会被淘汰。把里面的文字搬进一条新规则，类型选 Always Apply，和原来的效果一致，然后删掉旧文件。

## 资料来源

- [Cursor docs: Quickstart](https://cursor.com/docs/get-started/quickstart) (2026-11-05 查阅)
- [Cursor help: Download and install Cursor](https://cursor.com/help/getting-started/install) (2026-11-05 查阅)
- [Cursor help: Your first project](https://cursor.com/help/getting-started/first-project) (2026-11-05 查阅)
- [Cursor help: Agent mode](https://cursor.com/help/ai-features/agent) (2026-11-05 查阅)
- [Cursor help: Ask mode](https://cursor.com/help/ai-features/ask-mode) (2026-11-05 查阅)
- [Cursor docs: Cursor Agent](https://cursor.com/docs/agent/overview) (2026-11-05 查阅)
- [Cursor docs: Agent Security](https://cursor.com/docs/agent/security) (2026-11-05 查阅)
- [Cursor docs: Run Modes](https://cursor.com/docs/agent/security/run-modes) (2026-11-05 查阅)
- [Cursor docs: Agent Review](https://cursor.com/docs/agent/agent-review) (2026-11-05 查阅)
- [Cursor help: Rules](https://cursor.com/help/customization/rules) (2026-11-05 查阅)
- [Cursor help: Keyboard shortcuts](https://cursor.com/help/customization/keyboard-shortcuts) (2026-11-05 查阅)
- [Cursor help: Pricing](https://cursor.com/help/account-and-billing/pricing) (2026-11-05 查阅)
- [Cursor blog: Plan Mode](https://cursor.com/blog/plan-mode) (2026-11-05 查阅)
- [Cursor blog: Best practices for coding with agents](https://cursor.com/blog/agent-best-practices) (2026-11-05 查阅)
- [Cursor changelog](https://cursor.com/changelog) (2026-11-05 查阅)
- [Cursor changelog, page 2](https://cursor.com/changelog/page/2) (2026-11-05 查阅)
- [Wikipedia: Cursor (company)](https://en.wikipedia.org/wiki/Cursor_(company)) (2026-11-05 查阅)
- [Michael Truell on X, January 20, 2026](https://x.com/mntruell/status/2013636888242835810) (2026-11-05 查阅)
- [Lee Robinson on X, December 31, 2025](https://x.com/leerob/status/2006413745380114833) (2026-11-05 查阅)
- [leerob on YouTube: Cursor: coding agents tutorial (2026)](https://www.youtube.com/watch?v=kF2WQgk1LtY) (2026-11-05 查阅)

[浏览 MCP 服务器](https://mindket.com/cn/mcp-servers)