Azure Data Studio 安裝繁體中文套件的相容性問題紀錄(已停止更新)

更新註記(2026-09):這篇原本記錄 Azure Data Studio 安裝繁體中文語言套件時遇到的相容性問題。Azure Data Studio 已在 2026 年 2 月 28 日停止支援,不再提供更新或安全修正;新環境應改用 Visual Studio Code 與 MSSQL 擴充功能。以下保留原事件的排查脈絡,避免舊錯誤訊息被誤當成目前工具的安裝指南。

當時遇到的狀況

在 macOS 上使用 Azure Data Studio 時,從延伸模組市集安裝 Chinese (Traditional) Language Pack for Azure Data Studio 失敗,畫面顯示:

Error while installing 'Chinese (Traditional) Language Pack for Azure Data Studio' extension.
Please check logs for more details.

進一步查看相容性資訊後,安裝程式指出語言套件不支援當時的 Azure Data Studio 1.28.0。這種情況不是語言檔損壞,而是延伸套件宣告的支援版本與本機應用程式版本沒有交集。

舊環境的排查方式

  1. 先記下 Azure Data Studio 的完整版本、作業系統與錯誤訊息,不要只截取「安裝失敗」這一行。
  2. 到延伸套件的來源頁面比對支援版本與 release note,確認問題是在應用程式版本、套件版本,還是下載過程。
  3. 若必須維護舊專案,可下載與舊版相容的 .vsix 後離線安裝;但這只適合短期復原既有工作環境,不是長期更新策略。
  4. 任何手動下載的套件都要確認來源與雜湊,不要從不明鏡像取得可執行延伸模組。

原本曾從 Azure Data Studio 的延伸清單與 GitHub 專案追查版本,但這些連結現在只具歷史參考價值。因為產品已停止支援,即使找到可安裝的舊版,也不代表它仍適合處理新的資料庫工作。

現在應如何處理

新安裝或重新設定開發機時,直接使用 Visual Studio Code,安裝 Microsoft 的 MSSQL 擴充功能,再開啟原本的 SQL 指令碼與資料庫專案進行連線測試。Microsoft 說明現有查詢、指令碼與資料庫專案可直接移轉,不需要為了工具更換重寫內容。

若團隊仍有 Azure Data Studio,建議先列出它實際使用的連線、擴充功能與專案,再排定遷移;不要在正式機器上以「能開啟」作為仍受支援的判斷標準。這個差異對資料庫帳密與安全修正尤其重要。

參考資料

Author image
關於 Richard Zheng
About me 喜歡爬山,瑜伽,溜冰,喜歡新奇的事,最喜歡的還是寫程式帶來的成就感,對於資訊會不斷的出現新事物也能抱持好奇與熱忱。近期開始將學習的心得寫在Blog,發現思路更清晰也加深了記憶。 紙上得來終覺淺,絕知此事要躬行