建立 2026-09-14 更新 2026-09-14

組態檔

WSL 有兩層設定，不要寫錯地方。官方完整鍵值表：Advanced settings configuration。

檔案	位置	作用範圍
`.wslconfig`	Windows 的 `%USERPROFILE%\.wslconfig`	所有 WSL 2 發行版共用（記憶體、CPU、網路模式）
`wsl.conf`	發行版內的 `/etc/wsl.conf`	這一個發行版（掛載、hostname、systemd、預設使用者）

改完後必須讓 WSL 完全停掉再啟動。最省事：

wsl --shutdown

只關視窗往往不夠：背景的輕量 VM 可能還在跑。可用 wsl -l --running 確認。官方所說的「約 8 秒」是等子系統自己結束；--shutdown 則是立刻重來。

`.wslconfig`：限制資源與網路

用記事本或 VS Code 在使用者資料夾建立檔案（與 Documents 同層，檔名就是 .wslconfig）：

[wsl2]
memory=8GB
processors=4
swap=16GB
networkingMode=mirrored

memory 上限建議低於實體 RAM，留給 Windows 與瀏覽器。長期開著 WSL 時，若工作管理員看到記憶體只升不降，先 --shutdown；較新版本有 memory reclaim，官方示範見官方影音。

networkingMode=mirrored 僅 Windows 11 22H2 以上，說明見網路。

在發行版裡：

sudo nano /etc/wsl.conf

常見片段：

[boot]
systemd=true

[user]
default=yourname

[interop]
enabled=true
appendWindowsPath=true

systemd=true 讓 systemctl 可用，接近實體 Linux。需要 wsl --version 顯示足夠新的 Store 版 WSL。不需要服務管理就不必開。

appendWindowsPath=false 可避免 Windows 的 PATH 灌進 Linux（有時會讓 python 指到 Windows 版）。關掉之後，在 WSL 裡就不能直接靠 PATH 找到所有 .exe，要寫完整路徑。

一次改一個選項、--shutdown、確認行為，再改下一個。網路、GPU、systemd 同時改，出問題時很難判斷是哪一項。