新手指南：如何設定 WSL 2（Ubuntu 20.04）並整合 Docker

更新日期： 2025 年 3 月 13 日

如果你正在使用 Windows 但想體驗 Linux 環境，Windows Subsystem for Linux 2（WSL 2） 是一個非常方便的選擇。

透過 WSL 2，你可以在 Windows 上運行完整的 Linux 系統，而無需虛擬機或雙系統。

這對於開發者來說特別有用，因為它讓你可以在 Windows 環境中無縫使用 Linux 命令、Docker、Django 等工具。

本指南將手把手帶你完成 WSL 2（Ubuntu 20.04）的安裝與基本設定，並進一步教你如何將 Docker 整合進 WSL 2，讓你的開發環境更加順暢。現在就開始吧！🚀

設定 WSL 2（Ubuntu 20.04）

當你第一次設定 WSL 2，系統會要求你建立一個 Linux 使用者帳號。

這個帳號與 Windows 帳號無關，它只在 WSL（Ubuntu）內部使用。

設定 Linux 使用者名稱

當 WSL 2 提示：

Enter new UNIX username:

請輸入你的使用者名稱，建議：

• 使用小寫英文字母
• 避免特殊符號
• 簡單易記

範例：

myuser

輸入完成後，按 Enter。

設定密碼

接下來，系統會要求你設定密碼：

New password:

請注意：

• 輸入密碼時畫面不會顯示任何字元（也不會有 *），這是正常的，不用擔心。
• 直接輸入密碼後按 Enter。
• 系統會要求你再輸入一次密碼進行確認，輸入完成後再次按 Enter。

確認 WSL 2 Ubuntu 20.04 是否安裝成功

完成使用者名稱與密碼設定後，終端機會顯示：

myuser@DESKTOP-XXXXXX:~$

這代表你已經成功進入 Ubuntu 20.04 環境！🎉

要確認 WSL 2 是否正常運行，可以在 Windows PowerShell（非 WSL）執行：

wsl --list --verbose

如果顯示：

  NAME              STATE           VERSION
* Ubuntu-20.04      Running         2
  docker-desktop    Stopped         2

那麼你的 WSL 2（Ubuntu 20.04） 已經成功啟動！✅

設定 Docker 讓其使用 WSL 2

WSL 2 提供更好的性能與兼容性，因此建議讓 Docker 使用 WSL 2 來提升開發體驗。

開啟 Docker Desktop

如果你還沒安裝 Docker，可以前往 Docker 官網 下載並安裝 Docker Desktop。

安裝完成後，打開 Docker Desktop，然後按照以下步驟進行設定。

啟用 WSL 2 模式

在 Docker Desktop：

1. 進入 Settings（右上齒輪設定）
2. 前往 General（一般設定）
3. ✅ 勾選 "Use the WSL 2 based engine"（使用 WSL 2 引擎）
4. 點擊 Apply & Restart（套用並重啟）

啟用 Ubuntu 20.04 WSL 整合

1. 進入 Settings → Resources → WSL Integration
2. ✅ 找到 Ubuntu 20.04，啟用整合
3. 點擊 Apply & Restart

這樣 Docker 就會使用 WSL 2 + Ubuntu 20.04 來運行你的開發環境！

總結

現在你已經成功完成：

✅ 安裝並設定 WSL 2（Ubuntu 20.04）
✅ 確認 WSL 2 運行狀況
✅ 設定 Docker Desktop 以支援 WSL 2

這樣，你的 WSL 2 + Docker 環境 就已經準備就緒，可以開始開發了！