推荐使用一键命令行安装法:以管理员身份运行 powershell,执行 wsl --install,系统将自动启用功能、下载内核、安装 ubuntu 并提示重启;重启后首次启动设置用户名和密码即可完成部署。

如果您在 Windows 10 上尝试通过 WSL 安装 Ubuntu,但遇到命令不可用、安装失败或功能缺失等问题,则可能是由于系统版本过低、必要组件未启用或网络/商店限制所致。以下是针对不同场景的多种安装与设置方式:
一、一键命令行安装法(适用于 Windows 10 版本 2004 及以上、联网正常)
该方法调用 WSL 内置安装机制,自动启用子系统功能、下载 Linux 内核更新包,并安装默认 Ubuntu 发行版(通常为最新 LTS 版本),全程无需手动干预底层组件。
1、按 Win + X,选择“Windows 终端(管理员)”或“PowerShell(管理员)”。
2、输入命令并回车:wsl --install。
3、等待命令执行完成,系统将自动启用 WSL 功能、下载内核更新包、安装 Ubuntu 并提示重启。
4、重启计算机,使 Windows 功能变更与内核加载生效。
5、重启后,在“开始”菜单中点击 Ubuntu 图标,首次启动时设置用户名和密码(不可跳过,且后续无法通过图形界面修改)。
二、分步手动启用法(适用于旧版系统或 WSL 功能被禁用)
当 wsl --install 报错(如提示“未识别命令”、“Command not found”),通常因系统版本低于 2004 或 WSL 相关 Windows 功能处于禁用状态,此时需逐项启用核心依赖组件。
1、以管理员身份运行 Windows 终端(PowerShell)。
2、启用适用于 Linux 的 Windows 子系统:dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart。
3、启用虚拟机平台(WSL2 必需):dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart。
4、重启计算机。
5、重启后,再次以管理员身份打开终端,运行:wsl --set-default-version 2(设定 WSL2 为默认版本)。
6、运行:wsl --list --online 查看当前可安装的发行版列表。
7、安装指定 Ubuntu 版本(例如 Ubuntu 24.04):wsl --install -d Ubuntu-24.04 --web-download(--web-download 可绕过 Microsoft Store)。
三、离线 AppxBundle 安装法(适用于无网络或应用商店受限环境)
该方法绕过 Microsoft Store 和在线内核下载流程,通过预下载的 .AppxBundle 包完成部署,适用于企业内网、断网设备或策略限制禁止自动更新的场景。
1、在另一台联网设备上访问官方离线安装页:https://learn.microsoft.com/en-us/windows/wsl/install-manual,下载对应 Ubuntu 版本的 .AppxBundle 文件(如 Ubuntu-24.04_2404.1.29.0_x64.appxbundle)。
2、将文件复制至目标 Windows 10 电脑,保存路径建议为纯英文、无空格目录(如 C:\wsl\)。
3、以管理员身份打开 PowerShell,进入该目录:cd C:\wsl\。
4、执行安装命令(以 Ubuntu-24.04 为例):Add-AppxPackage .\Ubuntu-24.04_2404.1.29.0_x64.appxbundle(文件名需与实际一致)。
5、安装完成后,在“开始”菜单中点击 Ubuntu 图标启动,首次运行时设置用户名和密码。
四、安装后关键配置与注意事项
Ubuntu 安装成功后,需立即进行基础配置以保障稳定性与可用性,避免后续使用中出现权限异常、服务不可用或路径错误等问题。
1、更新软件源并升级系统:sudo apt update && sudo apt upgrade -y。
2、安装常用工具:sudo apt install -y curl git vim htop。
3、若需 systemd 支持(如运行 Docker Desktop 或某些后台服务),编辑 WSL 配置文件:sudo nano /etc/wsl.conf,添加以下内容:
[boot]
systemd=true
4、保存后退出(Ctrl+O → Enter → Ctrl+X),在 Windows PowerShell 中执行:wsl --shutdown,再重新打开 Ubuntu 使配置生效。
5、检查默认用户是否为 root(如需):在 Windows 命令行中进入 Ubuntu 安装目录(如 D:\Ubuntu),运行:ubuntu.exe config --default-user root。
6、确认 WSL 版本与内核状态:wsl --status,预期输出中“默认版本”应为 2,“内核版本”应不低于 5.15.x.x。











