---
title: "安裝與遷移"
description: "從 Cursor 官方安裝、VS Code 遷移和 JetBrains 遷移文件梳理安全遷移路徑。"
verifiedAt: "2026-05-09"
---

安裝 Cursor 本身不復雜，真正容易出錯的是遷移：把舊編輯器裡的擴充套件、快捷鍵、設定和專案習慣不加篩選地搬進來。Cursor 官方 Help Center 分別提供安裝、VS Code 遷移和 JetBrains 遷移說明，本章把它們整理成一條可控路徑。

> [!NOTE]
> **閱讀目標**：讀完本章，你應該能完成 Cursor 安裝，並判斷 VS Code / JetBrains 遷移時哪些可以直接匯入，哪些需要重新審查。

## 1. 官方安裝流程

官方 Help Center 給出的安裝步驟：

1. 開啟 [cursor.com/download](https://cursor.com/download)。
2. 點選當前作業系統對應的下載按鈕。
3. 開啟下載檔案。
4. 按系統完成安裝。
5. 開啟 Cursor。
6. 按提示登入 Cursor account。
7. 用 **File > Open Folder** 開啟專案目錄。

不同系統的具體動作：

| 系統 | 安裝動作 |
| --- | --- |
| macOS | 把 Cursor 拖到 Applications |
| Windows | 執行安裝器並按提示操作 |
| Linux | 優先用 apt / dnf 包；也可使用 AppImage 或 archive |

## 2. 從 VS Code 遷移

官方 VS Code 遷移文件說明，Cursor 可以一鍵匯入 VS Code settings、keybindings 和 extensions。

路徑：

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

匯入內容包括：

- extensions。
- themes。
- settings。
- keybindings。

> [!IMPORTANT]
> Cursor 使用 Open VSX extension registry（開放擴充套件登入檔，是 VS Code Marketplace 的開源替代品），不是 VS Code Marketplace。很多常見擴充套件可用，但不是所有 VS Code 擴充套件都一定存在或完全一致——部分商業 / 閉源擴充套件可能找不到對應版本。

## 3. 從 JetBrains 遷移

官方 JetBrains 遷移文件強調兩點：快捷鍵和專案模型。

保留快捷鍵肌肉記憶：

1. 開啟 Extensions panel。
2. macOS 按 `Cmd + Shift + X`，Windows / Linux 按 `Ctrl + Shift + X`。
3. 搜尋 `IntelliJ IDEA Keybindings`。
4. 安裝擴充套件。
5. Reload Cursor。

需要預期的差異：

| 差異 | 含義 |
| --- | --- |
| 專案模型 | Cursor 使用 file-and-folder project model（基於目錄的專案模型），而不是 JetBrains project system；不需要 `.idea/` 工程描述檔案 |
| 開啟方式 | 用 **File > Open Folder**，不是建立 JetBrains 專案 |
| 語言支援 | 依賴擴充套件，例如 Python、Go 等語言擴充套件 |
| 不完全切換 | 可以透過 ACP（Agent Client Protocol，代理客戶端協議）連線 Cursor agent 到 JetBrains IDE |

## 4. 遷移時不要照搬一切

從舊編輯器遷移時，建議分三層：

```mermaid
flowchart TD
  Old["舊編輯器配置"] --> Must["必須遷移"]
  Old --> Review["需要審查"]
  Old --> Drop["不遷移"]
  Must --> Keymap["快捷鍵 / 主題 / 基礎格式化"]
  Review --> Extensions["擴充套件 / AI 外掛 / 終端配置"]
  Drop --> Secrets["金鑰 / 本地臨時路徑 / 舊實驗配置"]
  Extensions --> Verify["開啟低風險專案驗證"]
```

可以遷移：

- 常用快捷鍵。
- 主題。
- 基礎格式化設定。
- 語言服務擴充套件。

需要重新審查：

- 會聯網的擴充套件。
- 舊 AI 外掛。
- 終端啟動指令碼。
- 自動格式化或儲存時執行命令。

不要遷移：

- 本機私有路徑。
- 明文金鑰。
- 客戶或生產環境憑據。
- 舊專案臨時 workaround。

<details>
<summary>深讀：為什麼遷移後先用低風險專案驗收</summary>

遷移會把舊編輯器習慣帶進 Cursor，但 Cursor 還會額外引入 Agent、Plan Mode、Rules、MCP、Terminal、Browser 和 Cloud Agent 等能力。一箇舊擴充套件或舊終端指令碼在普通 IDE 裡只是便利，在 AI agent 環境裡可能變成更大的副作用入口。

所以遷移完成後，先開啟低風險專案，跑一次只讀解釋、小改動、diff review 和檢查命令。確認沒有異常，再進入真實專案。
</details>

## 5. 安裝遷移驗收清單

至少確認：

- Cursor 來自官方下載入口。
- 已登入正確賬號。
- VS Code 匯入後擴充套件可用。
- JetBrains keymap 如需保留已安裝。
- 能用 **File > Open Folder** 開啟測試專案。
- Agent 能只讀解釋程式碼庫。
- 做一個小改動後能 review diff。
- 沒有把明文金鑰或生產憑據帶進 Cursor 配置。

## 本章自檢

完成本章後，用這 3 個問題檢查自己是否真正理解：

1. Cursor 從 VS Code 匯入哪些內容？擴充套件來源有什麼差異？
2. 從 JetBrains 遷移時，專案模型最大的變化是什麼？
3. 為什麼安裝遷移後不應該馬上開啟生產儲存庫？

透過標準：你能完成安裝和遷移，並用低風險專案驗證 Cursor 的基礎讀寫、diff review 和擴充套件狀態。

## 官方來源

- [Cursor Install Help](https://cursor.com/help/getting-started/install.md) —— 官方安裝流程和 File > Open Folder 起步方式。
- [Cursor Migrate from VS Code](https://cursor.com/help/getting-started/migrate-vscode.md) —— 官方 VS Code 設定、快捷鍵、主題和擴充套件匯入說明。
- [Cursor Migrate from JetBrains](https://cursor.com/help/getting-started/migrate-jetbrains.md) —— 官方 JetBrains keymap、file-and-folder project model、語言擴充套件和 ACP 說明。

## 接下來去哪

<Cards>
  <Card title="模型與定價" description="遷移完成後，再查模型、用量、Max Mode 和官方 pricing 邊界。" href="/zh-Hant/docs/cursor/official/00-getting-started/03-models-pricing" />
  <Card title="快速開始" description="回到第一天閉環：解釋程式碼庫、小改動、review diff 和檢查命令。" href="/zh-Hant/docs/cursor/official/00-getting-started/01-quickstart" />
</Cards>
