WSL2 操作手册

Windows Subsystem for Linux 文档 | Microsoft Learn

安装

只安装 WSL，不安装任何发行版

wsl --install --no-distribution

不推荐直接使用 wsl --install 会默认下载安装Ubuntu，可修改的发行版很少

# 未安装wsl时
wsl --list --online
以下是可安装的有效分发的列表。
使默认分发用 “*” 表示。
使用 'wsl --install -d <Distro>' 安装。

  NAME                            FRIENDLY NAME
* Ubuntu                          Ubuntu
  Debian                          Debian GNU/Linux
  kali-linux                      Kali Linux Rolling
  OracleLinux_7_9                 Oracle Linux 7.9
  OracleLinux_8_10                Oracle Linux 8.10
  OracleLinux_9_5                 Oracle Linux 9.5
  SUSE-Linux-Enterprise-15-SP6    SUSE Linux Enterprise 15 SP6
  openSUSE-Tumbleweed             openSUSE Tumbleweed

重启完成wsl安装后再进行安装发行版，有更多选择

wsl --list --online
以下是可安装的有效分发的列表。
使用“wsl.exe --install <Distro>”安装。

NAME                            FRIENDLY NAME
Ubuntu                          Ubuntu
Ubuntu-26.04                    Ubuntu 26.04 LTS
Ubuntu-24.04                    Ubuntu 24.04 LTS
Ubuntu-22.04                    Ubuntu 22.04 LTS
openSUSE-Tumbleweed             openSUSE Tumbleweed
openSUSE-Leap-16.0              openSUSE Leap 16.0
SUSE-Linux-Enterprise-15-SP7    SUSE Linux Enterprise 15 SP7
SUSE-Linux-Enterprise-16.0      SUSE Linux Enterprise 16.0
kali-linux                      Kali Linux Rolling
Debian                          Debian GNU/Linux
AlmaLinux-8                     AlmaLinux OS 8
AlmaLinux-9                     AlmaLinux OS 9
AlmaLinux-Kitten-10             AlmaLinux OS Kitten 10
AlmaLinux-10                    AlmaLinux OS 10
archlinux                       Arch Linux
FedoraLinux-44                  Fedora Linux 44
FedoraLinux-43                  Fedora Linux 43
eLxr                            eLxr 12.12.0.0 GNU/Linux
OracleLinux_7_9                 Oracle Linux 7.9
OracleLinux_8_10                Oracle Linux 8.10
OracleLinux_9_5                 Oracle Linux 9.5
SUSE-Linux-Enterprise-15-SP6    SUSE Linux Enterprise 15 SP6

wsl --install <Distro>

确认当前状态

# 查看wsl版本
wsl -v # wsl --version

# wsl帮助
wsl --help

# 查看所有发行版、版本和状态
wsl -l -v # 或 wsl --list --verbose

# 只看正在运行的
wsl -l --running

# 只看名称（适合脚本用）
wsl -l -q

# 更新 WSL
wsl --update

查找「可安装」的发行版

# 官方推荐的查看方式
wsl --list --online 
# 简写
wsl -l -o

设置 WSL 版本

wsl --set-version <distribution name> <versionNumber>

若要指定 Linux 发行版运行的 WSL 版本（1 或 2），请将 <distribution name> 替换为发行版的名称，并将 <versionNumber> 替换为 1 或 2。

# 设置默认 WSL 版本为 2
wsl --set-default-version 2

安装发行版

# 安装指定发行版
wsl --install -d <发行版名称>
# 不指定的话，默认装 Ubuntu
wsl --install

# `--location` 指定安装目录
wsl --install -d Ubuntu-24.04 --location D:\WSL\Ubuntu-24.04

# 设置默认发行版
wsl --set-default <发行版名称>

运行

# 运行默认发行版
wsl

# 运行指定发行版
wsl -d <发行版名称>

# 停止指定发行版
wsl -t <发行版名称>

# 以特定用户身份运行
wsl --user <Username>

# 更改分发版的默认用户
<发行版名称> config --default-user <Username>

# 关机,立即终止所有
wsl --shutdown

导出分发

# 确保已关闭
wsl --shutdown

# 导出 (默认为 tar 格式)
wsl --export <发行版名称> D:\WSL2\backup\ubuntu-24.04.tar
# 也可用 `--vhd` 导出为 .vhdx 文件

导入发行版

wsl --import <发行版名称> <InstallLocation> <FileName>

# 示例
wsl --import Ubuntu-24.04 D:\WSL2\Ubuntu-24.04 D:\WSL2\backup\ubuntu-24.04.tar --version 2

--vhd：指定导入分发应为 .vhdx 文件而不是 tar 文件（仅使用 WSL 2 支持）
--version <1/2>：指定是否将分发导入为 WSL 1 还是 WSL 2

注销和卸载

wsl --unregister <发行版名称>

装载磁盘或设备

# 装载磁盘
wsl --mount <DiskPath>

# 卸载磁盘
wsl --unmount <DiskPath>