啟用與設定 WSL2

在使用 WSL Dashboard 前，您需要在 Windows 系統中正確啟用和設定 WSL 2 環境。本節將引導您完成必要的基本設定。

1. 確認系統需求

WSL 2 對 Windows 版本有最低要求。按下 Win + R，輸入 winver 以檢查您的版本：

Windows 10: 需要版本 1903 或更高，且組建版本需為 18362 或更高。
Windows 11: 支援所有版本。

IMPORTANT

若您的版本過舊，請先透過「Windows Update」更新系統。

2. 啟用硬體虛擬化

WSL 2 基於虛擬化技術，因此您需要在主機板的 BIOS/UEFI 中啟用 Virtualization Technology。

檢查方法: 開啟「工作管理員」→「效能」標籤頁→「CPU」。
狀態確認: 確認右下角的「虛擬化」狀態顯示為 「已啟用」。
啟用方式: 若未啟用，您需要重新啟動電腦並進入 BIOS/UEFI 設定，找到如 Intel VT-x 或 AMD-V 的選項並設為 Enabled。

3. 啟用 Windows 相關功能

您需要啟用「Windows Subsystem for Linux」和「Virtual Machine Platform」Windows 功能。

方法 A: 透過圖形介面（推薦）

按下 Win + S，搜尋並開啟「開啟或關閉 Windows 功能」。
勾選以下兩個選項：
- Windows Subsystem for Linux (Windows 子系統適用於 Linux)
- Virtual Machine Platform (虛擬機平台)
點擊「確定」，並在提示時重新啟動電腦。

方法 B: 透過命令列（需管理員權限）

以管理員身份執行 PowerShell，並執行以下命令：

powershell

# 啟用 WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 啟用虛擬機平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

執行後，手動重新啟動電腦。

4. 安裝/更新 WSL 核心

現代 Windows 版本可透過 Microsoft Store 獲取 WSL 更新。

下載連結: Microsoft Store - Windows Subsystem for Linux
手動下載: 若無法使用 Store，可從 WSL GitHub Releases 下載最新的 .msixbundle 或 .msi 安裝包進行離線安裝。

5. 設定 WSL 2 為預設版本

為確保新安裝的發行版本預設使用 WSL 2，在終端機中執行：

powershell

wsl --set-default-version 2

常見問題

錯誤 0x80370102: 通常由 BIOS 中未啟用虛擬化或與 Hyper-V 衝突所致。
在 WSL 1 和 WSL 2 之間切換: 可使用 wsl --set-version <發行版本名稱> 2 將現有 WSL 1 執行個體升級至 WSL 2。

啟用與設定 WSL2 ​

1. 確認系統需求 ​

2. 啟用硬體虛擬化 ​

3. 啟用 Windows 相關功能 ​

方法 A: 透過圖形介面（推薦） ​

方法 B: 透過命令列（需管理員權限） ​

4. 安裝/更新 WSL 核心 ​

5. 設定 WSL 2 為預設版本 ​

常見問題 ​