---
title: "安裝、遷移和第一個專案"
description: "從下載安裝到遷移 VS Code / JetBrains，再用低風險專案跑通 Cursor 第一天閉環。"
verifiedAt: "2026-05-09"
---

第一次開啟 Cursor，不要急著讓 Agent 重構專案。正確目標是完成一個低風險、可回退、可驗證的 first project loop（首個專案閉環）：安裝可信、遷移可控、上下文可讀、改動可審查、驗證能跑通。

> [!NOTE]
> **本章目標**：你會完成安裝和遷移，並用一個小專案驗證 Cursor 的 read context、small edit、diff review 和 command check，而不是把真實生產儲存庫當試驗場。

## 1. 安裝階段只做三件事

官方安裝路徑很直接：

1. 從 [cursor.com/download](https://cursor.com/download) 下載。
2. 按系統安裝：macOS 拖入 Applications，Windows 執行 installer，Linux 優先用 apt / dnf 包，也可用 AppImage 或 archive。
3. 開啟 Cursor，登入 Cursor account，用 **File > Open Folder** 開啟專案目錄。

這一步不要混進太多配置。先確認你拿到的是官方安裝包，賬號是正確賬號，應用能開啟一個普通 folder。

## 2. VS Code 遷移：能匯入，但要篩選

Cursor 官方 Help Center 說明，可以從 VS Code 匯入 settings、keybindings、themes 和 extensions。

官方路徑：

1. 開啟 Cursor Settings。
2. macOS 按 `Cmd + Shift + J`，Windows / Linux 按 `Ctrl + Shift + J`。
3. 進入 **General > Account**。
4. 在 **VS Code Import** 下點選 **Import**。

但"能匯入"不等於"全部都該匯入"。Cursor 使用 Open VSX extension registry（開放擴充套件登入檔，是 VS Code Marketplace 的開源替代品），不是 VS Code Marketplace，所以擴充套件相容性和來源不完全相同——部分商業擴充套件可能在 Open VSX 找不到對應版本。

建議分三類處理：

- **直接匯入**：主題、基礎 keybindings、Prettier / ESLint 這類成熟格式化工具。它們行為可預測、與 AI 無關，遷過來不會衝突。
- **匯入後審查**：語言服務、Docker、database client、remote tools、Git helpers。這一類可能與 Cursor 自己的 AI 上下文有重疊或衝突，需要進專案跑一次再決定保留哪些。
- **不要直接遷移**：舊 AI 外掛、自動執行命令的擴充套件、帶本機路徑或賬號 token 的配置。舊 AI 外掛會和 Cursor 自己的 Agent 搶上下文；自動跑命令的擴充套件會讓許可權邊界變模糊。

## 3. JetBrains 遷移：先保留手感，再接受專案模型差異

從 JetBrains 切過來時，官方建議可以安裝 `IntelliJ IDEA Keybindings` 擴充套件來保留快捷鍵手感。安裝路徑：

1. 開啟 Extensions panel：macOS 按 `Cmd + Shift + X`，Windows / Linux 按 `Ctrl + Shift + X`。
2. 搜尋 `IntelliJ IDEA Keybindings`。
3. 安裝該擴充套件。
4. Reload Cursor 使快捷鍵生效。

更大的差異不是快捷鍵，而是 project model。

JetBrains 使用者需要預期：

- Cursor 使用 file-and-folder project model（基於目錄的專案模型）——和 JetBrains 的 IDEA Project 概念不同，Cursor 把"開啟 folder"等同於"開啟專案"，不需要先建立 `.idea/` 這種工程描述檔案。
- 開啟專案用 **File > Open Folder**。
- Python、Go、Java 等語言能力依賴相應 extensions。
- 如果暫時不想完全遷出 JetBrains，可以透過 ACP（Agent Client Protocol，代理客戶端協議）讓 Cursor agent 連線 JetBrains IDE。

也就是說，遷移不是把 IDE 複製一份，而是把工作流遷到 Cursor 的 folder、extensions、Agent 和 terminal 模型裡。

## 4. 第一個專案選什麼

第一個專案必須低風險。不要選客戶專案、生產後臺、支付鏈路、資料庫 migration 或金鑰很多的儲存庫。

合適的 first project：

- 有 Git。
- 能本地執行。
- 有 lint、test 或 build 命令。
- 規模不大，檔案結構清楚。
- 就算改錯也能直接丟棄 diff。

如果沒有合適專案，就新建一個臨時 demo repo。第一次練的是 Cursor 工作流，不是驗證它能不能一次性解決複雜系統問題。

## 5. 第一天 45 分鐘閉環

按這個順序執行：

```mermaid
flowchart TD
  A["Open Folder"] --> B["Check Git Status"]
  B --> C["Read-only Project Summary"]
  C --> D["One Small Change"]
  D --> E["Run Verification"]
  E --> F["Review Diff"]
  F --> G["Decide Keep or Revert"]
```

### Step 1：開啟專案後先看 Git

確認 working tree 乾淨，或者至少知道哪些改動不是 Cursor 做的。不要在一堆未識別改動上直接啟動 Agent。

### Step 2：只讀解釋專案

第一條 prompt 建議這樣寫：

```text
只读分析这个项目。不要修改文件，不要运行破坏性命令。
请输出：
1. 主要技术栈
2. 入口文件
3. 常用开发命令
4. 测试 / lint / build 命令
5. 你认为最安全的第一个小任务
```

這個步驟驗證 Cursor 能不能理解 project context，也驗證你能不能看懂它給出的判斷。

### Step 3：只做一個小改動

小改動可以是：

- 修一個文案 typo。
- 給一個純函式補 test。
- 給一個元件補 empty state。
- 給 docs 增加一段說明。
- 給已有 test case 補一個邊界。

不要第一次就做 dependency upgrade、authentication change、routing rewrite 或 database schema change。

### Step 4：跑驗證

讓 Cursor 執行最小驗證命令，例如 `pnpm lint`、`pnpm test -- <file>`、`pnpm build`。如果命令會很慢，先讓它解釋命令含義和風險，再決定是否執行。

### Step 5：審查 diff

看三件事：

- 是否只改了你批准的範圍。
- 是否引入無關格式化或大面積重排。
- 驗證結果是否和它的總結一致。

> [!IMPORTANT]
> Cursor 的 final summary 不能替代 diff review。上線質量來自真實改動、真實檢查和人工判斷。

## 6. 常見錯誤

第一次使用 Cursor 最容易犯這些錯誤：

- 登入錯賬號，後面才發現用量和團隊設定不對。
- VS Code 擴充套件全部匯入，舊 AI 外掛和自動化擴充套件互相干擾。
- 在未提交的真實專案裡直接讓 Agent 大改。
- prompt 裡沒有“不要修改檔案”或“先給計劃”。
- 沒有跑任何驗證，只看 Agent 文字總結。
- 改完後不沉澱 Rules，下一次重複踩坑。

## 7. 完成標準

第一次專案閉環完成時，你應該拿到：

- Cursor 已從官方入口安裝。
- VS Code / JetBrains 遷移項已篩選。
- 已開啟一個低風險專案。
- Cursor 已只讀解釋 project structure。
- 已完成一個 small edit。
- 已跑至少一個 verification command。
- 已看過 diff，並能決定 keep 或 revert。

具體到肉眼可見的樣子：你可能改了 1 個 typo、`pnpm lint` 透過、`git diff` 只有 1-3 行紅綠——這就算合格。如果第一次閉環跑完發現 diff 有 50+ 行散落改動，說明任務沒拆夠小，下次先把範圍再壓縮一半。

透過這個標準以後，再進入 Agent、Rules、MCP、Skills、CLI 和 Cloud Agent。

## 官方來源

- [Cursor Install Help](https://cursor.com/help/getting-started/install.md)：官方安裝步驟和 Open Folder 起步方式。
- [Migrate from VS Code](https://cursor.com/help/getting-started/migrate-vscode.md)：settings、keybindings、themes、extensions 匯入說明。
- [Migrate from JetBrains](https://cursor.com/help/getting-started/migrate-jetbrains.md)：keybindings、project model、language extensions 和 ACP 說明。
- [Cursor Documentation Index](https://cursor.com/llms.txt)：官方 Help Center 和 docs 頁索引。

## 接下來去哪

<Cards>
  <Card title="上一篇" description="先確認 Cursor 的產品定位和學習路線。" href="/zh-Hant/docs/cursor/understanding/01-what-is-cursor" />
  <Card title="下一篇" description="理解 Agent 的 instructions、tools、model、checkpoints 和 queue。" href="/zh-Hant/docs/cursor/understanding/03-how-cursor-agent-works" />
  <Card title="官方安裝遷移" description="回到官方重組頁檢視安裝與遷移細節。" href="/zh-Hant/docs/cursor/official/00-getting-started/02-install-and-migrate" />
</Cards>
