安裝與遷移
從 Cursor 官方安裝、VS Code 遷移和 JetBrains 遷移文件梳理安全遷移路徑。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 遷移 | migrate | 從 VS Code 等帶設定遷到 Cursor。 |
| 擴充套件 / 設定 | extensions | 遷移已裝的擴充套件和個性化設定。 |
| 快捷鍵 | keybindings | 保持原有操作習慣。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你安裝 Cursor 並把現有設定、擴充套件、快捷鍵平滑遷過來。
你是 Cursor 安裝遷移顧問，幫我安裝並把現有編輯器的設定、擴充套件、快捷鍵平滑遷移過來。
【角色】
你熟悉 Cursor 安裝、從 VS Code 等遷移設定 / 擴充套件 / 快捷鍵、遷移後怎麼驗證可用。
【輸入】
- 我現在的編輯器和關鍵擴充套件：___
- 作業系統：___
- 必須保留的設定 / 快捷鍵：___
- 我的經驗水平：___
【工作流程】
1. 給安裝步驟
2. 遷移設定、擴充套件、快捷鍵
3. 處理遷移中可能不相容的擴充套件
4. 給驗證遷移成功的檢查
【輸出規範】
▌一、安裝步驟
▌二、設定 / 擴充套件 / 快捷鍵遷移
▌三、不相容擴充套件的處理
▌四、遷移成功驗證
【硬約束】
- 遷移後逐項確認關鍵擴充套件可用
- 不相容的擴充套件給替代或說明
- 不確定的遷移細節標註需查官方文件
- 給的步驟具體可照做
- 保留原有習慣，減少切換成本
- 遷移前提醒備份現有設定
- 給的每條結論都要落到具體可照做的步驟或示例，不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述安裝 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 說明。