Cursor 快速開始
按 Cursor 官方 Quickstart，從安裝登入到第一次解釋程式碼庫、小改動、diff review 和 Plan Mode。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Quickstart | 快速開始 | 跑通第一個任務的最小步驟。 |
| 小改動 | small change | 可回復的第一個練手改動。 |
| Tab 補全 | tab | 邊寫邊接受的多行補全。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你在 Cursor 裡跑通第一個安全的小任務。
你是 Cursor 快速上手顧問，幫我跑通第一個安全、可回復的小任務，先體驗 Tab 和 Agent。
【角色】
你熟悉 Cursor 的最小上手步驟、第一次該做和不該做什麼、怎麼選第一個小改動。
【輸入】
- 我的專案和技術堆疊：___
- 想先改的一小處：___
- 是否有版本控制：___
- 我的經驗水平：___
【工作流程】
1. 給最小上手步驟
2. 用 Tab 體驗補全
3. 用 Agent 做一個可回復的小改動
4. 看 diff 並驗證
【輸出規範】
▌一、最小上手步驟
▌二、Tab 補全體驗
▌三、第一個 Agent 小改動
▌四、看 diff 與驗證
【硬約束】
- 第一個改動小且可回復
- 不碰主分支和不可逆操作
- 沒版本控制先建議加上
- 不確定的步驟標註需查官方文件
- 給的步驟具體可照做
- 提交前必看 diff
- 給的每條結論都要落到具體可照做的步驟或示例，不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述Cursor 官方 Quickstart 的目標很明確：從 install 到 first useful change。你要完成登入、讓 Cursor 解釋程式碼庫、做一個小改動、審查結果，然後知道什麼時候切到 Plan Mode。
第一天不要追求“讓 Agent 大改專案”。先跑通一個低風險閉環。
閱讀目標：讀完本章，你應該能在低風險專案裡完成一次可控的 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 命令）：
# macOS / Linux / WSL
curl https://cursor.com/install -fsS | bash
# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex下載入口用官方站，不要從網盤、第三方映象或所謂整合包開始。Cursor 會接觸程式碼、命令和賬號工作流，安裝源必須乾淨。
2. 先開啟低風險專案
官方 Quickstart 建議 pick a folder and start with a small task。第一天建議：
- 選擇 demo repo、文件儲存庫或非生產專案。
- 不要直接開啟包含生產金鑰的儲存庫。
- 不要讓 Cursor 一上來跑部署、刪除、遷移或賬單相關命令。
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 解釋程式碼庫並指出先讀哪裡。示例可以寫成：
Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes.中文專案可以這樣寫：
請只讀解釋這個程式碼庫。
請指出主要入口、關鍵模組、設定檔、測試入口，以及修改前必須先讀的檔案。
不要建立、修改或刪除任何檔案。這一步不是為了拿到漂亮總結，而是驗證 Cursor 能正確讀取目前 workspace，並能把專案結構講清楚。
4. 做一個小改動
官方建議先讓 Cursor suggest a few safe improvements，然後你選一個，再讓它改。
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。
驗收順序：
- 看 diff 是否只改目標檔案。
- 問 Cursor 為什麼這樣改。
- 跑專案已有檢查。
- UI 任務補截圖或本地預覽。
- 決定保留、繼續迭代或撤回。
不要只看 Cursor 的自然語言總結。真實驗收看 diff、測試輸出、瀏覽器結果和 Git 狀態。
6. 大任務切 Plan Mode
官方 Quickstart 說明，較大任務用 Plan Mode。切換方式是：在 agent input 裡按 Shift+Tab；輸入"重構 / 遷移 / 跨模組"等複雜關鍵詞時 Cursor 也會自動建議切到 Plan。
Plan Mode 會：
- Research your codebase to find relevant files。
- Ask clarifying questions about your requirements。
- Create a detailed implementation plan。
- Wait for your approval before building。
深讀：為什麼 Quickstart 先做小改動，而不是先跑大任務
Cursor 的核心價值是讓 Agent 參與真實開發，但第一天你還沒有驗證 workspace、規則、許可權、模型、命令和 review 習慣。小改動能讓你用最小風險跑通完整鏈路：讀程式碼、提出建議、修改、審 diff、跑檢查。
一旦這個閉環穩定，再把任務擴大到 Plan Mode。這樣遇到問題時，你知道是任務複雜度帶來的問題，而不是安裝、上下文或基礎使用方式沒跑通。
本章自檢
完成本章後，用這 3 個問題檢查自己是否真正理解：
- 官方 Quickstart 裡的 first useful change 應該包含哪些步驟？
- 為什麼第一條解釋程式碼庫 prompt 要強調只讀？
- 什麼情況下應該從普通 Agent 切到 Plan Mode？
透過標準：你能在一個低風險專案裡完成“解釋程式碼庫 -> 小改動 -> diff review -> 檢查命令”的閉環。
官方來源
- Cursor Quickstart —— 官方說明安裝登入、解釋程式碼庫、小改動、review diff、執行檢查和 Plan Mode。
- Cursor Install Help —— 官方 Help Center 安裝流程。