wsl(1) -- win11环境配置

1.前言

本专栏主要记录了我配置wsl的过程，以便日后回忆。

2. 开启WSL可选功能

打开设置，点击应用，点击可选功能，点击更多Windows功能，查看是否开启了【适用于Linux的Windows子系统】和【虚拟机平台】

3. 更新wsl

1. 不执行这步，启动wsl镜像时会出现WslRegisterDistribution failed with error: 0x8007019e，使用管理员身份执行命令行，执行以下命令，执行命令后会提示重启系统。

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

2. 不执行这步，启动wsl镜像时会出现WslRegisterDistribution failed with error: 0x800701bc。网上也有说可以下载wsl_update_x64.msi然后安装，我下载了安装发现没有解决问题。打开命令行执行以下命令，这个命令会联网下载一些文件。

wsl --update

3. 我下载的时候会卡很久，这时候打开Microsoft Store会看到有个正在下载的windows subsystem for linux，可以先暂停下载再点击继续，下载会从暂停的位置继续进行下载，但是下载的速度会快很多，过一会可能又停止不前了，可再次暂停和继续，直到下载完成，它会自动进行安装。
   

4. 安装Linux

1. wsl可通过命令安装，执行下面的命令可以列出当期网上可用的Linux镜像，然后选择一个进行安装

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

NAME                            FRIENDLY NAME
Ubuntu                          Ubuntu
Debian                          Debian GNU/Linux
kali-linux                      Kali Linux Rolling
Ubuntu-18.04                    Ubuntu 18.04 LTS
Ubuntu-20.04                    Ubuntu 20.04 LTS
Ubuntu-22.04                    Ubuntu 22.04 LTS
Ubuntu-24.04                    Ubuntu 24.04 LTS
OracleLinux_7_9                 Oracle Linux 7.9
OracleLinux_8_7                 Oracle Linux 8.7
OracleLinux_9_1                 Oracle Linux 9.1
openSUSE-Leap-15.6              openSUSE Leap 15.6
SUSE-Linux-Enterprise-15-SP5    SUSE Linux Enterprise 15 SP5
SUSE-Linux-Enterprise-15-SP6    SUSE Linux Enterprise 15 SP6
openSUSE-Tumbleweed             openSUSE Tumbleweed

2. 也可以到Microsoft Store中进行搜索，然后安装，下载支持断点续传，下载过程中如果会卡住，可以先暂停再继续下载，下载完成后会自动安装。安装完成后点击打开，第一次打开会提示设置用户名密码，然后就可以使用了。

5. 迁移WSL

WSL默认安装到了C盘，可以通过命令进行迁移

wsl --help # 查看命令行帮助
wsl -l -v # 查看当前已安装的Linux，以及运行状态
wsl --shutdown # 如果镜像处于Running状态，则应先停止镜像
wsl --export Ubuntu-24.04 d:\Ubuntu-24.04.tar # 将Ubuntu-24.04镜像导出为Ubuntu-24.04.tar文件，大约1.03GB
wsl --unregister Ubuntu-24.04 # 卸载已安装的镜像，镜像对应的文件会被删除
wsl -l -v # 可以看到被卸载的镜像消失了
wsl --import Ubuntu-24.04 d:\Ubuntu-24.04 d:\Ubuntu-24.04.tar # 通过tar导入镜像，并设置镜像的安装位置为d:\Ubuntu-24.04，安装后会生成d:\Ubuntu-24.04\ext4.vhdx，大约1.9GB
wsl -l -v # 可以看到新安装的镜像，名称前面标注有型号的表示默认的发行版
wsl --set-default Ubuntu-24.04 # 将Ubuntu-24.04设置为默认的发行版
Ubuntu2404 config --default-user xflm # 修改新镜像的默认用户，迁移后默认用户为root，xflm是我安装Linux时设定的用户名
wsl # 即可启动Linux镜像进入shell

6. 资源配置

参考官方文档Advanced settings configuration in WSL可以配置WSL的资源，比如可用处理器数量、内存、内存交换等。

---

下一篇：wsl(2) – ubuntu24.04配置
目录：wsl – 集合

7. 参考

Win11 安装 Docker Desktop 和 WSL2 并进行安装位置迁移
官方文档