ianhuang筆記THE ADVENTURER'S JOURNAL
知識世界・持續探索中

ADVENTURE JOURNAL · 探索筆記

Windows WSL 2 與 Docker:安裝前檢查及錯誤排除

任務導覽 TABLE OF CONTENTS

保留 0x80370102 與 0xc03a001a 情境,補上虛擬化、WSL 狀態與 Docker 整合的診斷順序。

適用:Windows 的 WSL 2 與 Docker Desktop。原錯誤記錄屬於舊版 WSL,以下使用狀態檢查與官方排錯路線;本次 macOS 未實機重現。

安裝前確認

使用支援 WSL 2 的 Windows 10/11 與目前 Docker Desktop 支援的版本。以系統管理員 PowerShell 檢查:

wsl --status
wsl --version
wsl --list --verbose

舊 WSL 可能不認識 –version,先按官方更新路線確認,不表示 Linux distribution 壞掉。首次安裝依 Microsoft 檔案執行 wsl --install,完成後可能需重新啟動。Docker Desktop 選 WSL 2 backend 並啟用指定 distribution 的 integration。

錯誤診斷

0x80370102 先檢查 UEFI/BIOS 虛擬化、Windows Virtual Machine Platform 與重新啟動;若 Windows 本身在 VM,主機還需允許 nested virtualization。不要看到錯誤就先 unregister distribution,該動作會刪資料。

0xc03a001a 常與虛擬磁碟檔案被壓縮/加密或所在磁碟屬性有關。原筆記以取消 AppData 目錄壓縮處理,但不同 Store/WSL 版本的資料位置不同;先依實際錯誤和官方排錯查出 VHD 位置,備份後調整相關屬性,不修改整個使用者目錄。

確認 Docker

在已啟用整合的 Linux shell 執行:

docker version
docker run --rm hello-world

應有 Server 資訊與 Hello from Docker。若只有 Windows 終端正常、WSL 不正常,檢查 integration 與 PATH。檔案大量 IO 的專案可放在 Linux 檔案系統,再從 VS Code Remote WSL 操作,避免把差異誤判為容器效能。

參考資料

冒險者留言

comments powered by Disqus

搜尋筆記

輸入關鍵字,探索所有筆記。

ESC 關閉 · 搜尋標題、標籤與文章全文