Intro

WSL: Windows Subsystem for Linux

WSL是嵌在Windows里面的超小Linux VM, 默认是ubuntu

主页： https://github.com/microsoft/WSL

一键安装（在线安装）

wsl --install

问题： wsl --install 非常慢，主要是因为微软境外源在国内带宽差。最快解决：离线手动安装（国内镜像下载），几分钟搞定

手工安装（离线安装）

前置说明

Windows11 家庭版完全支持 WSL2，无需 Hyper-V，只用开启两个系统功能、安装你下载的 MSI、导入 wsl 镜像即可，全程离线可用。

步骤 0：下载

wsl程序

https://github.com/microsoft/WSL/releases 下载 wsl.2.7.3.0.x64.msi文件

Ubuntu wsl文件

根据 https://github.com/microsoft/WSL/blob/master/distributions/DistributionInfo.json 文件，里面有各个distro的url。

找到https://releases.ubuntu.com/26.04/ 的 WSL image的下载链接， 下载ubuntu-26.04-wsl-amd64.wsl文件

把以上两个文件放在一个全英文的路径下比如： D:\wsl

附加国内高速地址（未验证）

用浏览器 / 迅雷下载：

  1. WSL2 内核（msi） - 地址：https://gh-proxy.org/https://github.com/microsoft/WSL/releases/download/2.7.1/wsl.2.7.1.0.x64.msi
  2. Ubuntu 22.04（tar.gz）（清华镜像） - 地址：https://mirrors.tuna.tsinghua.edu.cn/ubuntu-releases-wsl/22.04/ubuntu-22.04-wsl-amd64.tar.gz

保存到：D:\wsl\（纯英文路径）

步骤 1：开启 WSL 必备系统功能

  1. 右键开始菜单 → 选择Windows 终端 (管理员) 或 PowerShell (管理员)
  2. 依次执行两条命令，不用重启：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  1. 重启电脑生效

步骤 2：安装 WSL 核心 MSI 包

  1. 找到你下载的 wsl.2.7.3.0.x64.msi
  2. 双击直接安装，一路下一步默认即可
  3. 安装完关闭窗口，不用额外配置

步骤 3：导入 Ubuntu26.04 .wsl 镜像

双击ubuntu-26.04-wsl-amd64.wsl 文件，会自动倒入。

导入过程中会提示你输入用户和密码

也可以用以下步骤手工倒入

  1. 新建一个纯英文路径文件夹（建议非 C 盘），例如：D:\WSL\Ubuntu2604
  2. 把下载好的 ubuntu-26.04-wsl-amd64.wsl 放到无中文、无空格的路径下，比如 D:\WSL\
  3. 打开普通 PowerShell（不用管理员），执行导入命令：
wsl --import Ubuntu2604 D:\WSL\Ubuntu2604 D:\WSL\ubuntu-26.04-wsl-amd64.wsl --version 2

参数解释：

  • Ubuntu2604：自定义发行版名字（随意改）
  • D:\WSL\Ubuntu2604：存放 WSL 系统文件的目录
  • 最后是你.wsl文件的完整路径
  • --version 2：强制使用 WSL2

步骤 4：初始化并使用 Ubuntu

  1. 启动刚导入的系统：

powershell下

wsl -d Ubuntu2604 
// 命令行会自动进入VM的shell
  1. 首次启动会提示创建 Linux 用户名和密码，按提示设置即可
  2. 验证是否为 WSL2：

powershell下

wsl -l -v
// -l 表示 list
// -v 表示verbose输出，会输出version

看到版本为2就成功了。

常见问题解决

  1. 导入报错路径含中文 / 空格：把文件和文件夹全改成英文无空格
  2. 启动卡在初始化：执行 wsl --shutdown 再重新启动
  3. 想设为默认系统：wsl --set-default Ubuntu2604
  4. 想卸载：wsl --unregister Ubuntu2604

wsl命令

启动VM

wsl -d <distro-name>

启动distro 的VM,并且进入 它的shell

创建和改默认用户

# 创建用户（替换为你想要的名字）
useradd -m -G sudo -s /bin/bash yourname
passwd yourname

# 设为默认用户
echo -e "[user]\ndefault=yourname" >> /etc/wsl.conf

Shutdown / reboot VM

wsl --terminate Ubuntu wsl -d Ubuntu

更多资源