更新註記(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。這種情況不是語言檔損壞,而是延伸套件宣告的支援版本與本機應用程式版本沒有交集。
舊環境的排查方式
- 先記下 Azure Data Studio 的完整版本、作業系統與錯誤訊息,不要只截取「安裝失敗」這一行。
- 到延伸套件的來源頁面比對支援版本與 release note,確認問題是在應用程式版本、套件版本,還是下載過程。
- 若必須維護舊專案,可下載與舊版相容的
.vsix後離線安裝;但這只適合短期復原既有工作環境,不是長期更新策略。 - 任何手動下載的套件都要確認來源與雜湊,不要從不明鏡像取得可執行延伸模組。
原本曾從 Azure Data Studio 的延伸清單與 GitHub 專案追查版本,但這些連結現在只具歷史參考價值。因為產品已停止支援,即使找到可安裝的舊版,也不代表它仍適合處理新的資料庫工作。
現在應如何處理
新安裝或重新設定開發機時,直接使用 Visual Studio Code,安裝 Microsoft 的 MSSQL 擴充功能,再開啟原本的 SQL 指令碼與資料庫專案進行連線測試。Microsoft 說明現有查詢、指令碼與資料庫專案可直接移轉,不需要為了工具更換重寫內容。
若團隊仍有 Azure Data Studio,建議先列出它實際使用的連線、擴充功能與專案,再排定遷移;不要在正式機器上以「能開啟」作為仍受支援的判斷標準。這個差異對資料庫帳密與安全修正尤其重要。
