loading...
Windows Subsystem for Linux安装教程与使用方法（GUI与终端安装）
发表于：2024-11-13 |
字数统计: 2.4k | 阅读时长: 9分钟 | 阅读量：

WSL2安装教程与使用方法（GUI与终端安装）

前言

注意，本教程会过时！！！请永远以官方文档 安装 WSL | Microsoft Learn 为准。如果你要当时间警察当我没说。

昨天与琉璃一起安装的时候盲目按照自己2021年初的方法配置，自己硬造出来了一大堆bug，现在看了官方文档以后发现很多地方都不一样了，特别是当年WSL1刚刚出的时候，配置极其繁琐与麻烦，现在的配置步骤相较于以前已经精简了许多。

这里推荐一下Windows应用商店里面全新构建的终端Windows Terminal|微软应用商店 ，长得颜值还可以，字体也比较好看，各种颜色都比较丰富，可以一试。（本人极其颜控，软件长得丑会极大地衰减学习兴趣）

导航

Windows 11 & Windows 10 2004（内部版本19041）及以上用户请查看：GUI版安装教程

Windows 10 LTSC 2021 用户请查看：终端自动安装教程；或者在启用微软应用商店后查看GUI版安装教程

Windows LTSC和Server和版本号低于2004的用户请查看手动安装教程

GUI版安装教程（小白强烈推荐）

常规安装步骤

  1. 首先请确保你的Windows版本大于Windows10 2004（内部版本号19041）。

    查看方法：按下Win+R，输入winver，弹出的对话框中即可显示当前的系统版本。

  2. 直接在Microsoft Store中搜索Ubuntu 24.04 LTS或者你想要的版本（Debian，ArchLinux等）如下图，点击安装。

    image-20241113112142656

  3. 微软应用商店会帮你处理所有事情，理论上来讲经历两次重启以后（第一次在点下安装的1分钟左右，第二次在安装完成之前），就可以用了。

  4. 按下Win+S，输入Powershell或cmd或者你自己安装的终端。输入

    1
    wsl -l -v

    应当显示如下内容：

    image-20241113112011487

  5. 安装完毕

问题汇总：

  1. 目前大部分WSL应用均要求WSL2，如果你在应用商店安装过后发现上述步骤三中的截图中Version显示为1，则应当使用以下命令将WSL版本切换为2

    1
    wsl --set-version Ubuntu-24.04 2

    请将上文中的 Ubuntu-24.04 更改为自己想切换的发行版

    想知道WSL1和WSL2的区别以及什么时候需要使用WSL1，请参考官方文档：比较 WSL 版本 | Microsoft Learn

  2. 如果你想安装的版本应用商店里面没有，或者是你没有微软应用商店，请参考下文终端自动安装方式。

  3. 在微软应用商店安装Ubuntu 20.04 LTS时，可能在执行 wsl --update 的时候报错，内容如下：

    img

    再次执行 wsl --install 和其他的所有wsl操作时，会出现以下界面，报错1603，并永远卡死在这里：

    img

    经查询全网都没有解决方法，也没有人提出相关问题。自己以前倒是遇到过此类情况，原因为安装软件时软件错误地配置了注册表键值权限，导致它自己没有足够的权限，无法配置。我在电脑上重新安装了WSL2，发现这些键值会重新出现，因此个人认为直接删除这几个目录即可。注意：如有疑虑请自行考虑解决方法。

    以管理员身份运行终端，输入：

    1
    2
    3
    4
    reg delete HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Drive\shell\WSL /f
    reg delete HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Directory\background\shell\WSL /f
    reg delete HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Directory\shell\WSL /f

    执行完毕后问题解决。

  4. 报错**%1 is not a valid Win32 application**

    请移步wsl的安装 | T琉璃T，琉璃姐姐有记录此问题，我未能复现，无法提供帮助。

终端自动安装

常规步骤

  1. 首先请确保你的Windows版本大于Windows10 2004（内部版本号19041）。如果你没有微软应用商店，可能会出错，请转至问题汇总-LTSC

  2. 执行命令

    1
    wsl --install

  3. 该指令将会自动启用Windows相关功能并给你安装Ubuntu的最新LTS发行版。如果你不想安装Ubuntu，可以使用以下指令

    1
    2
    3
    wsl --install --no-distribution		#安装WSL但是不带任何发行版
    wsl --list --online		#列出所有可用的发行版
    wsl --install <发行版名称>	#安装选定的发行版

  4. 安装完成以后使用 wsl -l -v来查看安装的发行版，显示应该和上文中图片一样。

问题汇总：

  1. Windows 10 LTSC版在安装时因为没有微软应用商店可能会出现各种乱七八糟的问题。为了解决这个问题，我暂且提供三种方法。

    • 使用wsreset -i命令直接重置微软应用商店，稍后他会自动安装。

    • 在第一行命令的末尾加上 --inbox，此命令将使用Windows更新来安装WSL而不是微软应用商店。注意：此命令将会开启Windows更新，如果你此前禁用了Windows更新，将会失效。

      在第三行命令末尾加上--web-download，此命令将从网络下载而不是从Microsoft Store，但需要良好的网络环境。

    • 使用下文的手动安装方法。

  2. 在安装发行版的时候，LTSC版本也会因为没有微软应用商店而出很多错误。例如：在使用 wsl --update的时候也会出现一大堆bug，请使用 --web-download参数来从网络下载而不是从Microsoft Store。因此强烈建议使用 wsreset -i安装微软应用商店。你如果是“极客”当我没说。

手动安装教程

常规步骤

  1. 检查自己的系统版本是否为：

    x64系统：1903 或更高版本（内部版本为 18362.1049 ）

    ARM系统：2004 或更高版本（内部版本为 19041）

    请勿问出例如：“如何在不支持的系统上安装WSL这种系统级组件”这种弱智问题，你要是能做到可以去参与日本的Windows2000 Modernization计划

  2. 输入以下命令以启用Windows的虚拟机服务和WSL服务

    1
    2
    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

  3. 下载WSL2的安装包

  4. 将WSL2设置为默认

    1
    wsl --set-default-version 2

  5. 下载发行版 .appx 安装包

  6. 打开Windows Powershell（或者其他什么的终端也行），切换到 .appx 包所在的目录并运行：

    1
    Add-AppxPackage .\<包名>.appx

  7. 等待安装完成后可以输入 wsl -l -v查看是否安装完成。

问题汇总

  1. 在执行 wsl --update的时候可能会报错，请使用 --web-download参数来从网络下载而不是从Microsoft Store。
  2. 步骤二以后如果无法安装WSL2的msi包可以尝试重启

WSL常用命令汇总

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
# 安装WSL并指定Linux发行版
wsl --install  # 默认安装Ubuntu
 --distribution <发行版名称>：指定安装的发行版
 --no-launch：安装后不自动启动
 --web-download：在线下载安装
 --inbox：使用Windows组件安装WSL（非Microsoft Store）
 --enable-wsl1：启用WSL 1组件
 --no-distribution：不安装任何发行版

# 查看在线可用发行版列表
wsl --list --online  # 别名：wsl -l -o

# 查看已安装的Linux发行版列表及状态
wsl --list --verbose  # 别名：wsl -l -v
 --all：列出所有发行版
 --running：仅列出当前运行的发行版
 --quiet：仅显示发行版名称

# 将指定发行版设置为WSL1或WSL2
wsl --set-version <发行版名称> <1/2>  # 切换WSL版本

# 设置WSL默认版本
wsl --set-default-version <1/2>

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

# 将目录切换至主目录
wsl ~  # 启动WSL并切换至主目录

# 以指定用户身份运行特定发行版
wsl --distribution <发行版名称> --user <用户名>


# 更新WSL至最新版本
wsl --update
 --web-download：从GitHub而非Microsoft Store下载更新

# 检查WSL状态
wsl --status

# 检查WSL版本
wsl --version

# 帮助命令
wsl --help

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

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

# 关闭所有运行的WSL进程
wsl --shutdown  

# 终止指定发行版
wsl --terminate <发行版名称>

# 获取WSL 2安装的Linux发行版IP地址
wsl hostname -I  

# 导出发行版
wsl --export <发行版名称> <文件名>  
 --vhd：导出为.vhdx文件（仅WSL2支持）

# 导入发行版
wsl --import <发行版名称> <安装路径> <文件名>  
 --vhd：导入.vhdx文件
 --version <1/2>：导入WSL1或WSL2

# 即时导入VHDX文件作为发行版
wsl --import-in-place <发行版名称> <文件名>

# 注销或卸载发行版
wsl --unregister <发行版名称>

# 挂载磁盘至WSL
wsl --mount <磁盘路径>
 --vhd：虚拟硬盘
 --name <名称>：挂载点名称
 --bare：仅附加磁盘，不挂载
 --type <文件系统类型>：文件系统类型
 --partition <分区号>：指定挂载分区
 --options <挂载选项>：特定文件系统的挂载选项

# 卸载磁盘
wsl --unmount <磁盘路径>

教程 WSL
上一篇:
WSL使用指南&常用命令（持续更新）
下一篇:
STM32学习笔记（一）【施工中】

    • Copyright © 2017 - 2024 bisucrose | Powered by Hexo | Theme Bamboo