Skip to content

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

快速安裝

目標是在 Windows 10/11 用一條指令裝好 WSL 2 與 Ubuntu,重開機後就能進 Linux。

系統需求

  • Windows 11,或 Windows 10 版本 2004(組建 19041)以上
  • 需要系統管理員權限
  • WSL 2 需要 CPU 支援 SLAT(現在的 64 位元電腦幾乎都有),且 BIOS/UEFI 已開啟虛擬化(Intel VT-x 或 AMD-V)

較舊的 Windows 請改走 手動安裝步驟

一條指令

系統管理員開啟 PowerShell 或命令提示字元:

wsl --install

這條指令會:

  1. 啟用 WSL 與 Virtual Machine Platform
  2. 下載最新 Linux kernel
  3. 把預設版本設成 WSL 2
  4. 安裝 Ubuntu(可改發行版,見 發行版怎麼選

完成後重開機。沒重開,功能與發行版常會卡在半安裝狀態。

只想裝 WSL、暫時不安發行版:

wsl --install --no-distribution

公司電腦無法用 Microsoft Store 時,更新可改走網路套件:

wsl --update --web-download

第一次進入 Linux

重開機後,開始功能表搜尋 Ubuntu(或你選的發行版)並開啟。第一次會要求:

  • UNIX 使用者名稱:建議小寫英文,不要用空格
  • 密碼:輸入時不會顯示字元,這是 Linux 慣例;這組帳密獨立於 Windows 登入

忘記 Linux 密碼時,可在 PowerShell 以 root 進該發行版再重設,細節見 疑難排解

接著更新套件(Ubuntu/Debian):

sudo apt update && sudo apt upgrade -y

sudo 是「暫時以系統管理員執行」。第一次會問剛才設的 Linux 密碼。

確認安裝成功

Windows 的 PowerShell(不必系統管理員):

wsl --status
wsl -l -v
wsl --version

預期會看到預設發行版、WSL 2,以及 WSL/kernel 版本。wsl --version 若無法辨識,代表還在較舊的「收件匣」WSL,請先 wsl --update

進入 Linux 後:

whoami
pwd
lsb_release -a

應顯示你的 Linux 使用者、家目錄(通常是 /home/你的名稱),以及發行版版本。

之後怎麼開

  • 開始功能表開啟發行版名稱
  • Windows 終端機選 Ubuntu 設定檔(建議,見 終端機
  • PowerShell 輸入 wslwsl ~~ 會進家目錄,而不是目前的 Windows 資料夾)

官方逐步說明:Install WSLSet up a WSL development environment。裝好後請先讀 檔案系統,避免一開始就把專案放在 /mnt/c