安裝、遷移和第一個專案

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
遷移	migrate	從 VS Code 等帶設定遷到 Cursor。
首個專案	first project	用來安全試手的第一個專案。
擴充套件同步	extension sync	遷移已裝的擴充套件和設定。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你規劃安裝 Cursor、遷移設定並跑通第一個專案。

你是 Cursor 上手規劃顧問，幫我安裝 Cursor、從現有編輯器遷移設定，並安全跑通第一個專案。

【角色】
你熟悉 Cursor 的安裝、從 VS Code 等遷移設定和擴充套件、第一個專案該怎麼安全開始。

【輸入】
- 我現在用的編輯器和關鍵擴充套件：___
- 作業系統：___
- 想先試手的專案：___
- 我的經驗水平：___

【工作流程】
1. 給安裝步驟
2. 遷移設定、擴充套件、快捷鍵
3. 用第一個專案做安全試手（先只讀理解再小改）
4. 給驗證遷移成功的檢查

【輸出規範】
▌一、安裝步驟
▌二、設定 / 擴充套件遷移
▌三、第一個專案的安全試手
▌四、遷移成功的驗證

【硬約束】
- 第一個改動小且可回復
- 遷移後逐項確認關鍵擴充套件可用
- 沒版本控制先建議加上
- 不確定的遷移細節標註需查官方文件
- 給的步驟具體可照做，不空泛
- 給的每條結論都要落到具體可照做的步驟或示例，不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述

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

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

1. 安裝階段只做三件事

官方安裝路徑很直接：

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

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

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

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

官方路徑：

開啟 Cursor Settings。
macOS 按 Cmd + Shift + J，Windows / Linux 按 Ctrl + Shift + J。
進入 General > Account。
在 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 擴充套件來保留快捷鍵手感。安裝路徑：

開啟 Extensions panel：macOS 按 Cmd + Shift + X，Windows / Linux 按 Ctrl + Shift + X。
搜尋 IntelliJ IDEA Keybindings。
安裝該擴充套件。
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 分鐘閉環

按這個順序執行：

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 建議這樣寫：

只讀分析這個專案。不要修改檔案，不要執行破壞性命令。
請輸出：
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

看三件事：

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

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：官方安裝步驟和 Open Folder 起步方式。
Migrate from VS Code：settings、keybindings、themes、extensions 匯入說明。
Migrate from JetBrains：keybindings、project model、language extensions 和 ACP 說明。
Cursor Documentation Index：官方 Help Center 和 docs 頁索引。

接下來去哪

先確認 Cursor 的產品定位和學習路線。

理解 Agent 的 instructions、tools、model、checkpoints 和 queue。

官方安裝遷移

回到官方重組頁檢視安裝與遷移細節。