---
title: "快速开始"
description: "按 Cursor 官方 Quickstart，从安装登录到第一次解释代码库、小改动、diff review 和 Plan Mode。"
verifiedAt: "2026-05-09"
---

Cursor 官方 Quickstart 的目标很明确：从 install 到 first useful change。你要完成登录、让 Cursor 解释代码库、做一个小改动、审查结果，然后知道什么时候切到 Plan Mode。

第一天不要追求“让 Agent 大改项目”。先跑通一个低风险闭环。

> [!NOTE]
> **阅读目标**：读完本章，你应该能在低风险项目里完成一次可控的 Cursor 任务：解释代码库、选一个小改动、审 diff、跑检查。

## 1. 安装并登录

官方 Quickstart 和 Help Center 都要求先安装 Cursor 并登录。不同系统要求：

| 平台 | 官方要求或路径 |
| --- | --- |
| macOS | macOS 12 Monterey 及以上；`.dmg` 原生安装器；支持 Apple Silicon 和 Intel |
| Windows | Windows 10 及以上；`.exe` 原生安装器 |
| Debian / Ubuntu | 推荐 apt repo 安装 |
| RHEL / Fedora | 推荐 yum / dnf repo 安装 |
| AppImage | 可 portable 使用，但 apt / yum 更推荐 |

官方说明 apt / yum 包比 AppImage 更优先，因为它们提供 desktop icons、automatic updates 和 CLI tools。

如果偏好命令行，Cursor 也提供一键安装脚本（同时安装 GUI + CLI `agent` 命令）：

```bash
# macOS / Linux / WSL
curl https://cursor.com/install -fsS | bash

# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex
```

> [!IMPORTANT]
> 下载入口用官方站，不要从网盘、第三方镜像或所谓整合包开始。Cursor 会接触代码、命令和账号工作流，安装源必须干净。

## 2. 先打开低风险项目

官方 Quickstart 建议 pick a folder and start with a small task。第一天建议：

- 选择 demo repo、文档仓库或非生产项目。
- 不要直接打开包含生产密钥的仓库。
- 不要让 Cursor 一上来跑部署、删除、迁移或账单相关命令。

```mermaid
flowchart TD
  Install["安装并登录"] --> Folder["打开低风险 folder"]
  Folder --> Explain["让 Cursor 解释代码库"]
  Explain --> Small["选择一个小改动"]
  Small --> Diff["Review diff"]
  Diff --> Checks["运行 tests / typecheck / lint / build"]
  Checks --> Plan["较大任务再用 Plan Mode"]
```

## 3. 让 Cursor 解释代码库

官方 Quickstart 推荐打开 Agent，然后让 Cursor 解释代码库并指出先读哪里。示例可以写成：

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

中文项目可以这样写：

```text
请只读解释这个代码库。
请指出主要入口、关键模块、配置文件、测试入口，以及修改前必须先读的文件。
不要创建、修改或删除任何文件。
```

这一步不是为了拿到漂亮总结，而是验证 Cursor 能正确读取当前 workspace，并能把项目结构讲清楚。

## 4. 做一个小改动

官方建议先让 Cursor suggest a few safe improvements，然后你选一个，再让它改。

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

适合第一天的小任务：

| 任务 | 原因 |
| --- | --- |
| 改一段文案 | 风险低，diff 容易读 |
| 修一个小 UI 问题 | 可以截图验证 |
| 补一个简单测试 | 可用测试命令验收 |
| 改 README 小节 | 不影响运行时 |

不适合第一天：

- 重构目录结构。
- 升级多个依赖。
- 修改认证、支付、部署配置。
- 运行生产环境命令。

## 5. Review diff 并验证

官方 Quickstart 明确要求 review the diff，并让 Cursor 运行项目已有检查：tests、type checker、linting 或 local build。

验收顺序：

1. 看 diff 是否只改目标文件。
2. 问 Cursor 为什么这样改。
3. 跑项目已有检查。
4. UI 任务补截图或本地预览。
5. 决定保留、继续迭代或撤回。

> [!WARNING]
> 不要只看 Cursor 的自然语言总结。真实验收看 diff、测试输出、浏览器结果和 Git 状态。

## 6. 大任务切 Plan Mode

官方 Quickstart 说明，较大任务用 Plan Mode。切换方式是：在 agent input 里按 `Shift+Tab`；输入"重构 / 迁移 / 跨模块"等复杂关键词时 Cursor 也会自动建议切到 Plan。

Plan Mode 会：

1. Research your codebase to find relevant files。
2. Ask clarifying questions about your requirements。
3. Create a detailed implementation plan。
4. Wait for your approval before building。

<details>
<summary>深读：为什么 Quickstart 先做小改动，而不是先跑大任务</summary>

Cursor 的核心价值是让 Agent 参与真实开发，但第一天你还没有验证 workspace、规则、权限、模型、命令和 review 习惯。小改动能让你用最小风险跑通完整链路：读代码、提出建议、修改、审 diff、跑检查。

一旦这个闭环稳定，再把任务扩大到 Plan Mode。这样遇到问题时，你知道是任务复杂度带来的问题，而不是安装、上下文或基础使用方式没跑通。
</details>

## 本章自检

完成本章后，用这 3 个问题检查自己是否真正理解：

1. 官方 Quickstart 里的 first useful change 应该包含哪些步骤？
2. 为什么第一条解释代码库 prompt 要强调只读？
3. 什么情况下应该从普通 Agent 切到 Plan Mode？

通过标准：你能在一个低风险项目里完成“解释代码库 -> 小改动 -> diff review -> 检查命令”的闭环。

## 官方来源

- [Cursor Quickstart](https://cursor.com/docs/get-started/quickstart.md) —— 官方说明安装登录、解释代码库、小改动、review diff、运行检查和 Plan Mode。
- [Cursor Install Help](https://cursor.com/help/getting-started/install.md) —— 官方 Help Center 安装流程。

## 接下来去哪

<Cards>
  <Card title="安装与迁移" description="如果要从 VS Code 或 JetBrains 迁移，继续看设置、扩展和快捷键边界。" href="/docs/cursor/official/00-getting-started/02-install-and-migrate" />
  <Card title="Plan Mode" description="较大任务继续学习 Plan Mode 的研究、提问、计划和审批流程。" href="/docs/cursor/official/01-agent-workflow/12-plan-mode" />
</Cards>
