Skip to content

WSL 版本相容性說明 ​

如果偵測到你的 WSL 版本不在 WSL Dashboard 的支援範圍內,程式會顯示提示。在不受支援的版本上執行,可能造成兩個問題:

  • 資料安全有風險:壓縮、稀疏 VHD、複製、匯入與匯出等操作會直接讀寫虛擬磁碟,在不受支援的版本上可能導致資料毀損。
  • 部分功能可能無法正常運作:例如 [boot]、[gpu]、[time] 等設定項目在舊版本上不支援。

請先將 WSL 更新至支援的版本,再使用完整功能。

一、檢查目前版本 ​

以系統管理員身分開啟 PowerShell,執行:

powershell
wsl --version

記下「WSL 版本」一行的數值。若該命令發生錯誤或沒有這一行,代表你使用的是 Windows 內建的舊版 WSL,請直接依下列步驟升級。

二、如何升級 ​

方式一:直接下載安裝程式(推薦,升級更快更穩定) ​

優先前往官方發佈頁面:

https://github.com/microsoft/WSL/releases/latest

選擇最新(或支援範圍內)的版本,下載 wsl.<version>.x64.msi(ARM64 裝置請選 arm64),按兩下即可安裝。

需 Windows 10 21H2 以上,且已在「開啟或關閉 Windows 功能」中啟用「虛擬機器平台」。

方式二:命令列更新 ​

以系統管理員身分在 PowerShell 中執行:

powershell
wsl --update

若 Store 無法使用,可強制執行:

powershell
wsl --update --web-download

三、升級後 ​

powershell
wsl --shutdown
wsl --version

確認版本已落在支援範圍內後,完全結束並重新啟動 WSL Dashboard,提示即會消失。

相關連結 ​