安裝與遷移
從 Cursor 官方安裝、VS Code 遷移和 JetBrains 遷移文件梳理安全遷移路徑。
安裝 Cursor 本身不復雜，真正容易出錯的是遷移：把舊編輯器裡的擴充套件、快捷鍵、設定和專案習慣不加篩選地搬進來。Cursor 官方 Help Center 分別提供安裝、VS Code 遷移和 JetBrains 遷移說明，本章把它們整理成一條可控路徑。
閱讀目標：讀完本章，你應該能完成 Cursor 安裝，並判斷 VS Code / JetBrains 遷移時哪些可以直接匯入，哪些需要重新審查。
1. 官方安裝流程
官方 Help Center 給出的安裝步驟：
- 開啟 cursor.com/download。
- 點選當前作業系統對應的下載按鈕。
- 開啟下載檔案。
- 按系統完成安裝。
- 開啟 Cursor。
- 按提示登入 Cursor account。
- 用 File > Open Folder 開啟專案目錄。
不同系統的具體動作：
| 系統 | 安裝動作 |
|---|---|
| macOS | 把 Cursor 拖到 Applications |
| Windows | 執行安裝器並按提示操作 |
| Linux | 優先用 apt / dnf 包；也可使用 AppImage 或 archive |
2. 從 VS Code 遷移
官方 VS Code 遷移文件說明，Cursor 可以一鍵匯入 VS Code settings、keybindings 和 extensions。
路徑：
- 開啟 Cursor Settings。
- macOS 按
Cmd + Shift + J，Windows / Linux 按Ctrl + Shift + J。 - 進入 General > Account。
- 在 VS Code Import 下點選 Import。
匯入內容包括：
- extensions。
- themes。
- settings。
- keybindings。
Cursor 使用 Open VSX extension registry（開放擴充套件登入檔，是 VS Code Marketplace 的開源替代品），不是 VS Code Marketplace。很多常見擴充套件可用，但不是所有 VS Code 擴充套件都一定存在或完全一致——部分商業 / 閉源擴充套件可能找不到對應版本。
3. 從 JetBrains 遷移
官方 JetBrains 遷移文件強調兩點：快捷鍵和專案模型。
保留快捷鍵肌肉記憶：
- 開啟 Extensions panel。
- macOS 按
Cmd + Shift + X，Windows / Linux 按Ctrl + Shift + X。 - 搜尋
IntelliJ IDEA Keybindings。 - 安裝擴充套件。
- 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. 遷移時不要照搬一切
從舊編輯器遷移時，建議分三層：
flowchart TD
Old["舊編輯器配置"] --> Must["必須遷移"]
Old --> Review["需要審查"]
Old --> Drop["不遷移"]
Must --> Keymap["快捷鍵 / 主題 / 基礎格式化"]
Review --> Extensions["擴充套件 / AI 外掛 / 終端配置"]
Drop --> Secrets["金鑰 / 本地臨時路徑 / 舊實驗配置"]
Extensions --> Verify["開啟低風險專案驗證"]可以遷移：
- 常用快捷鍵。
- 主題。
- 基礎格式化設定。
- 語言服務擴充套件。
需要重新審查：
- 會聯網的擴充套件。
- 舊 AI 外掛。
- 終端啟動指令碼。
- 自動格式化或儲存時執行命令。
不要遷移：
- 本機私有路徑。
- 明文金鑰。
- 客戶或生產環境憑據。
- 舊專案臨時 workaround。
深讀：為什麼遷移後先用低風險專案驗收
遷移會把舊編輯器習慣帶進 Cursor，但 Cursor 還會額外引入 Agent、Plan Mode、Rules、MCP、Terminal、Browser 和 Cloud Agent 等能力。一箇舊擴充套件或舊終端指令碼在普通 IDE 裡只是便利，在 AI agent 環境裡可能變成更大的副作用入口。
所以遷移完成後，先開啟低風險專案，跑一次只讀解釋、小改動、diff review 和檢查命令。確認沒有異常，再進入真實專案。
5. 安裝遷移驗收清單
至少確認：
- Cursor 來自官方下載入口。
- 已登入正確賬號。
- VS Code 匯入後擴充套件可用。
- JetBrains keymap 如需保留已安裝。
- 能用 File > Open Folder 開啟測試專案。
- Agent 能只讀解釋程式碼庫。
- 做一個小改動後能 review diff。
- 沒有把明文金鑰或生產憑據帶進 Cursor 配置。
本章自檢
完成本章後，用這 3 個問題檢查自己是否真正理解：
- Cursor 從 VS Code 匯入哪些內容？擴充套件來源有什麼差異？
- 從 JetBrains 遷移時，專案模型最大的變化是什麼？
- 為什麼安裝遷移後不應該馬上開啟生產儲存庫？
透過標準：你能完成安裝和遷移，並用低風險專案驗證 Cursor 的基礎讀寫、diff review 和擴充套件狀態。
官方來源
- Cursor Install Help —— 官方安裝流程和 File > Open Folder 起步方式。
- Cursor Migrate from VS Code —— 官方 VS Code 設定、快捷鍵、主題和擴充套件匯入說明。
- Cursor Migrate from JetBrains —— 官方 JetBrains keymap、file-and-folder project model、語言擴充套件和 ACP 說明。