安裝、遷移和第一個專案

第一次開啟 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。

官方安裝遷移

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