WSL安装记录（自用）

WSL安装记录

基本信息：

系统版本：Windows 11 家庭中文版
系统版本号：24H2
系统状态：刚刚运行过 win11 电脑C盘重置（删除所有内容）
文章内容更新：日期2026.1.16；时间11：18：15
内容由豆包AI提供
全程需要管理员身份打开 PowerShell
下载版本：Ubuntu 24.04

一、准备工作

启用 WSL 和虚拟机平台组件

powershell执行以下两条命令：

bash 复制代码

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

结果：

bash 复制代码

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

结果：

完成后重启电脑，再次以管理员身份打开 PowerShell

更新适用于 Linux 的 Windows 子系统为最新版本

可直接进行下一步，系统会自动提醒你

或powershell执行：

css 复制代码

wsl.exe --update

结果：

设置 WSL 2 为默认版本

powershell执行：

arduino 复制代码

wsl --set-default-version 2

结果：

本人：在 E 盘新建用于存放 WSL 系统文件的文件夹

手动添加或powershell执行

arduino 复制代码

mkdir E:\WSL\Ubuntu-24.04

执行结果：

资源管理器显示：

二、下载 Linux 发行版镜像

微软提供了官方的 WSL 发行版镜像包，本人下载 Ubuntu 24.04 ：

打开浏览器，访问微软官方镜像列表：learn.microsoft.com/zh-cn/windo...
找到 Ubuntu 24.04 LTS 的下载链接，点击下载

将下载的文件 Ubuntu2404-240425.AppxBundle 后缀改为 .zip，解压后找到其中的Ubuntu_2404.0.5.0_x64.appx，再重复改后缀为 .zip解压，找到其中的 install.tar.gz 文件（这是 Linux 系统的核心镜像），复制到 E:\WSL 目录下。

三、手动导入镜像到 E 盘

在管理员 PowerShell 中执行导入命令，格式如下：

xml 复制代码

wsl --import <发行版名称> <安装路径> <镜像文件路径> --version 2

本人使用命令：

arduino 复制代码

wsl --import Ubuntu-24.04 E:\WSL\Ubuntu-24.04 E:\WSL\install.tar.gz --version 2

执行成功后，无报错即表示导入完成。

四、设置默认用户（避免默认 root）

刚导入的 WSL 默认用户是 root，需要手动设置普通用户：

先进入 WSL 系统，powershell执行：
复制代码
```
wsl -d Ubuntu-24.04
```

结果：

在 Linux 命令行中创建用户（替换 iqnus 为你想要的用户名）：

创建普通用户，同时创建用户的家目录，默认shell是bash

bash 复制代码

useradd -m -s /bin/bash iqnus

给这个用户设置登录密码（密码输入时不显示，输完回车即可，Linux的安全机制），本人记录密码为iqnus123

复制代码

passwd iqnus

结果：

把这个用户加入sudo用户组，赋予管理员权限（执行sudo命令时输入密码即可提权）

复制代码

usermod -aG sudo iqnus

在 PowerShell 中配置默认用户：

在 Ubuntu 里创建并编辑配置文件

bash 复制代码

sudo nano /etc/wsl.conf

写入配置内容

ini 复制代码

[user] 
default = iqnus

按下 Ctrl + O → 保存文件（O 是字母 O，不是数字 0），会提示文件名，直接按回车确认

按下 Ctrl + X → 退出 nano 编辑器，回到命令行

退出 WSL：

执行

bash 复制代码

exit

结果：

关闭并重启 WSL：
arduino 复制代码
```
wsl --shutdown
wsl -d Ubuntu-24.04
```

此时默认用户就会变成你创建的普通用户。

Ubuntu 初始化操作（更新系统，不做会卡顿）

刚安装的 Ubuntu 是纯净版，软件源是国外的，先执行更新命令，把系统软件包更新到最新版，后续安装 Python/Java/Node 等开发工具才不会报错

sql 复制代码

sudo apt update && sudo apt upgrade -y

等待所有get结束。

如果界面卡住，可以按一下回车，会刷新显示当前进度的界面。

exit 退出，wsl --shutdown 结束进程。

五、验证安装

powershell执行以下命令，查看 WSL 信息：

css 复制代码

wsl --list --verbose

资源管理器打开E:\WSL\Ubuntu-24.04,可以看到ext4.vhdx在该目录中。

WSL安装记录（自用）