---
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="/zh-Hant/docs/cursor/official/00-getting-started/02-install-and-migrate" />
  <Card title="Plan Mode" description="較大任務繼續學習 Plan Mode 的研究、提問、計劃和審批流程。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/12-plan-mode" />
</Cards>
