在快速迭代的軟體開發領域，工具的更新換代如同呼吸般自然。而 Cursor AI，這款結合了人工智慧的程式碼編輯器，更是以其獨特的優勢吸引了眾多開發者。然而，隨著版本的更新，如何順利升級並整合個人習慣的擴充功能，往往成為一個挑戰。本文將深入探討 Cursor AI 的最新版本升級流程，並提供詳細的步驟，幫助您在更新後，重新找回熟悉的開發環境，甚至進一步優化您的工作流程。
為何要關注 Cursor AI 的版本更新？
Cursor AI 不斷進步，每次更新都可能帶來更強大的 AI 功能、更流暢的使用體驗、更廣泛的語言支援，以及重要的安全修補。對於依賴 Cursor 進行開發的專業人士來說，及時更新不僅能確保工具的穩定性，更能讓您搶先體驗最新技術，保持競爭力。如同 參考資料 所強調的，較新版本的 Cursor AI 在擴充功能處理機制上與舊版本有顯著差異，這意味著直接的遷移可能不再適用，需要採取更為精確的升級策略。
升級前的準備工作：備份與了解
在進行任何重大軟體更新之前，備份是至關重要的第一步。對於 Cursor AI 而言，這同樣適用。雖然參考資料中將備份步驟標註為「可選」，但強烈建議您遵循。
備份現有 Cursor 應用程式（macOS 為例）
若您使用的是 macOS，可以執行以下指令來備份您的 Cursor 應用程式：
sudo mv /Applications/Cursor.app/ /Applications/Cursor_backup.app
這個指令會將當前正在使用的 Cursor 應用程式移動到一個名為 `Cursor_backup.app` 的新資料夾中，以便在升級過程中出現問題時能夠快速回滾。
了解新版本的架構差異
最新的 Cursor 版本（例如文中提到的 1.5.5 版本，搭配 VSCode 1.99.3）可能在底層架構或擴充功能管理方式上有所調整。這使得過去直接指向 MS Extension Marketplace 的方法不再有效。升級策略需要適應這種變化，例如，需要透過特定指令來繞過或修補某些安全檢查，確保新版本的正常運作。
詳細升級步驟（以 macOS 為例）
以下將逐步引導您完成 Cursor AI 的最新版本升級，並重新配置您所需的擴充功能。
第一階段：下載與安裝最新版本
- 前往官方下載頁面： 根據您參考的資料，應從 Cursor AI downloads 頁面下載最新版本的 DMG 安裝檔。
- 掛載 DMG 檔案： 使用 `hdiutil mount` 指令掛載下載的 DMG 檔案。例如：
hdiutil mount Cursor-darwin-*.dmg - 複製應用程式： 將掛載的 Cursor 應用程式複製到您的 Applications 資料夾：
sudo cp -R /Volumes/Cursor\ Installer/Cursor.app /Applications/請注意，卷宗名稱 `Cursor\ Installer` 中的雙反斜線是為了處理空格。
- 卸載與清理： 完成複製後，卸載 DMG 檔案並刪除下載的 DMG 檔：
hdiutil unmount /Volumes/Cursor\ Installer rm -f Cursor-darwin-*.dmg
第二階段：強制程式碼簽署檢查與套用補丁
為了讓新版本的 Cursor 順利運行，可能需要強制其程式碼簽署檢查並套用特定的補丁。這一點在 參考資料 中有明確提及。
執行以下指令，以驗證 Cursor 的版本並確保其首次啟動時能順利載入：
/Applications/Cursor.app/Contents/Resources/app/bin/cursor --version
接著，透過 curl 指令下載並執行由 `@realdimas` 提供的 `package.json` 補丁腳本。這個腳本旨在修復與擴充功能市場相關的設定，確保 Cursor 能夠正確地指向正確的伺服器。
curl -sL "https://gist.githubusercontent.com/realdimas/e58723564cfada8efd93adab6efb747c/raw/d6c0ff85ce979637b4d6fb0033b0a736fbe332cf/fix-product-json.sh" | sudo bash
第三階段：配置與安裝擴充功能
這是最關鍵的步驟之一，需要仔細管理您常用的擴充功能。
3.1 準備擴充功能列表
創建兩個純文字檔案：
- `cursor-exts.txt`： 記錄您希望從 Cursor 專有市場安裝的所有擴充功能 ID。每行一個 ID。以 `#` 開頭的行將被視為註解，並被忽略。
- `vscode-exts.txt`： 記錄您希望從官方 Microsoft VS Code Marketplace 安裝的所有擴充功能 ID。同樣，每行一個 ID，`#` 開頭為註解。
重要提示： 根據 參考資料 的建議，請不要在 `vscode-exts.txt` 中加入 `ms-python.vscode-pylance` (Pylance) 或 `ms-python.python` (Python) 的擴充功能 ID。這兩個擴充功能需要特殊的處理，因為 Pylance 在較新版本的 Cursor 中需要一個特定的補丁版本，並且依賴於比標準安裝版本更新的 `ms-python` 版本。
3.2 清除現有擴充功能並重新安裝
在繼續之前，請務必關閉 Cursor.app。然後，在您創建擴充功能列表檔案的相同終端機路徑下，執行以下指令：
- 清除現有擴充功能： 這將移除所有先前安裝的擴充功能，包括可能引起衝突的 `anysphere.cursorpyright`。
/bin/rm -rf ~/.cursor/extensions/* - 安裝 Cursor 專有擴充功能： 使用 `curl` 和提供的腳本來安裝 `cursor-exts.txt` 中列出的擴充功能。
curl -sL "https://gist.githubusercontent.com/joeblackwaslike/802b9ddc135ba85d31a14b21b341807a/raw/c698a2e3fa73296bdd61258b5faf1f2dc37e174f/get-cursor-exts.sh" | bash -s -- --input-file cursor-exts.txt - 安裝 Microsoft Marketplace 擴充功能：
- macOS 用戶： 如果您在 macOS 上，可能需要先安裝 `grep`，因為系統預設的 `grep` 可能與腳本不完全相容。
brew install grep - 安裝指令： 使用類似的 `curl` 腳本來安裝 `vscode-exts.txt` 中的擴充功能。
curl -sL "https://gist.githubusercontent.com/joeblackwaslike/306d6c7548f0c01f6626891d3d125066/raw/1448e70705e2eca8bb1154d5972cc8b756153e10/get-ms-exts.sh" | bash -s -- --input-file vscode-exts.txt
- macOS 用戶： 如果您在 macOS 上，可能需要先安裝 `grep`，因為系統預設的 `grep` 可能與腳本不完全相容。
3.3 手動處理 Python 及 Pylance 擴充功能
由於 Pylance 的特殊需求，我們需要手動處理：
- 下載 Python 擴充功能 VSIX 檔： 從指定的 URL 下載最新版本的 `ms-python.python` 擴充功能的 VSIX 檔案。
curl https://ms-python.gallery.vsassets.io/_apis/public/gallery/publisher/ms-python/extension/python/2025.13.2025080801/assetbyname/Microsoft.VisualStudio.Services.VSIXPackage -o ms-python.python_2025.13.2025080801.vsix - 使用 Cursor 安裝 Python 擴充功能：
cursor --install-extension ms-python.python_*.vsix - 執行 Pylance 補丁腳本： 使用 `uv run` 指令執行 Pylance 的補丁腳本，以生成補丁後的 Pylance VSIX 檔案。
uv run --script https://gist.githubusercontent.com/realdimas/c025cdba50cc05e0f644eb71bf7efbb9/raw/pylance_patcher.py - 安裝補丁後的 Pylance：
cursor --install-extension ms-python.vscode-pylance-*-patched.vsix
第四階段：配置設定並驗證
為了確保 Cursor AI 的穩定運行並避免自動更新帶來的潛在問題，需要調整其設定檔。
4.1 停用自動更新
修改 Cursor 的 `settings.json` 檔案，停用 Windows 背景更新和一般的更新模式。
jq '.["update.enableWindowsBackgroundUpdates"] = false' ~/Library/Application\ Support/Cursor/User/settings.json > temp.json && mv temp.json ~/Library/Application\ Support/Cursor/User/settings.json
jq '.["update.mode"] = "none"' ~/Library/Application\ Support/Cursor/User/settings.json > temp.json && mv temp.json ~/Library/Application\ Support/Cursor/User/settings.json
注意： `jq` 是一個 JSON 處理工具，如果您的系統上沒有安裝，需要先進行安裝。
4.2 設定 Pylance 為預設 Python 語言伺服器
同樣透過 `jq` 指令，將 `python.languageServer` 設定為 `Pylance`，確保 Pylance 能夠正確啟用。
jq '.["python.languageServer"] = "Pylance"' ~/Library/Application\ Support/Cursor/User/settings.json > temp.json && mv temp.json ~/Library/Application\ Support/Cursor/User/settings.json
4.3 處理特定擴充功能的衝突
在新版本中，`anysphere.cursorpyright` 擴充功能可能會被自動重新啟用，導致衝突。您需要手動刪除它。
/bin/rm -rf ~/.cursor/extensions/anysphere.cursorpyright-* || /bin/rm -rf ~/.cursor/extensions/anysphere.cursorpyright-*
第一次執行可能無法徹底清除，因此提供了再次執行的指令。
4.4 驗證工作區設定
如果在您的本地工作區或專案設定檔（`settings.json` 或 `.code-workspace` 檔案）中，發現 `python.languageServer` 被設定為 `None`，這將會覆蓋使用者設定。您可以選擇移除本地設定，讓其繼承使用者設定，或將其值改為 `Pylance`。
4.5 （macOS）重簽署應用程式
對於 macOS 用戶，為了確保應用程式的完整性，可能需要重新簽署 Cursor.app。
codesign --force --deep --sign - /Applications/Cursor.app
第五階段：最後的驗證與疑難排解
重新啟動 Cursor.app，檢查所有您常用的擴充功能是否正常運作。如果遇到問題，特別是與主題相關的顯示異常，請檢查您的 `settings.json`，移除或重新設定不相容的主題。
從參考資料中獲取的關鍵洞見
在分析參考資料的過程中，我們提煉出以下幾個重要的結論：
- 擴充功能管理機制的重大變革： 最新版本的 Cursor AI 在擴充功能處理上，已不再直接依賴 MS Extension Marketplace，這意味著舊有的擴充功能導入方式已失效，需要新的策略來管理和安裝擴充功能，包括手動下載 VSIX 檔案和使用客製化腳本。
- Pylance 的特殊處理需求： Pylance 擴充功能在最新版本的 Cursor AI 中，需要額外的步驟來確保其正常運行。這包括下載特定版本的 VSIX 檔案，使用補丁腳本進行修改，然後再手動安裝。此類操作凸顯了 Cursor AI 在整合特定 AI 工具時，可能需要更精細的配置。
- 繞過安全檢查與市場指向的必要性： 修改 `product.json` 檔案 來重新指向 Microsoft 的 Marketplace 服務，以及執行補丁腳本，是確保 Cursor AI 能夠正確載入和管理擴充功能的關鍵步驟，這暗示了 Cursor AI 可能為了提供差異化功能而進行了某些市場或伺服器的重定向。
總結
升級 Cursor AI 並重新配置擴充功能，雖然過程繁瑣，但這對於維持一個高效、穩定的開發環境至關重要。透過本文詳述的步驟，您可以順利完成從舊版本到最新版本的遷移，並確保您喜愛的工具都能在新環境中發揮最大效用。記住，持續關注官方更新資訊，並謹慎操作，將是您在軟體開發道路上不斷前進的基石。
如果您希望獲取更多關於 AI、創業及 Funding 的即時資訊，並與同好交流，請加入我們的專屬頻道。
Source：https://gist.github.com/joeblackwaslike/752b26ce92e3699084e1ecfc790f74b2
English 
Chinese 