在 WSL2 上安装 Ubuntu:零基础详细指南
一、什么是 WSL2?为什么选择它?
-
WSL (Windows Subsystem for Linux): 微软官方开发的兼容层,让你直接在 Windows 上运行原生 Linux 程序。
-
WSL2: 第二代架构,基于轻量级虚拟机技术(Hyper-V),提供:
-
接近原生 Linux 的性能(尤其文件系统)
-
完整的系统调用兼容性
-
无缝集成:在 Windows 中访问 Linux 文件,在 Linux 中访问 Windows 文件
-
-
Ubuntu: 流行、易用且社区支持强大的 Linux 发行版,非常适合新手。
二、安装前准备:系统要求与检查
-
操作系统版本要求:
-
Windows 10:版本 2004(内部版本 19041)或更高(推荐 21H2+)
-
Windows 11:所有版本均支持
-
检查方法:按
Win + R,输入winver,回车查看版本号。
-
-
启用 BIOS/UEFI 中的虚拟化 (Virtualization):
-
这是运行 WSL2 的必备条件!
-
检查是否已启用:
-
按
Ctrl + Shift + Esc打开任务管理器。 -
切换到“性能”选项卡。
-
查看右下角“虚拟化”状态:
-
已启用:完美,继续下一步。
-
已禁用:需要进入 BIOS/UEFI 设置开启(通常叫
Intel VT-x、AMD-V、SVM或Virtualization Technology)。重启电脑,在开机 Logo 出现时狂按F2、F10、Del或Esc(品牌不同按键不同)进入 BIOS/UEFI 设置,找到相关选项并启用,保存退出。
-
-
-
常见错误提示:如果安装时遇到
0x80370102错误,几乎都是虚拟化未开启导致。
-
-
预留磁盘空间:确保你的系统盘(通常是 C 盘)有 5GB 以上可用空间。
三、详细安装步骤:一步步跟着做
步骤 1:启用 WSL 和虚拟机平台功能
-
以管理员身份打开 PowerShell:
-
在 Windows 搜索栏输入
powershell。 -
右键单击“Windows PowerShell”,选择“以管理员身份运行”。
-
在弹出的 UAC 提示中点击“是”。
-
-
输入并执行以下两条命令(逐条复制粘贴,按回车执行):
powershell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
-
说明:第一条启用 WSL,第二条启用虚拟机平台(支持 WSL2)。
-
结果:命令执行完成后会提示“操作成功完成”。此时需要重启电脑!
-
步骤 2:将 WSL 2 设置为默认版本
-
电脑重启后,再次以管理员身份打开 PowerShell。
-
输入并执行命令:
powershell
wsl --set-default-version 2
-
说明:这条命令让之后安装的所有 Linux 发行版都默认使用 WSL2。
-
预期输出:
操作成功完成。 -
可能的情况:如果提示需要更新 WSL 内核,请访问 Manual installation steps for older versions of WSL | Microsoft Learn 下载并安装
适用于 x64 计算机的 WSL2 Linux 内核更新包,安装后再次运行上面的命令。
-
步骤 3:安装 Ubuntu 发行版
-
打开 Microsoft Store (微软商店)。
-
在搜索框中输入
Ubuntu。 -
选择
Ubuntu(通常是最新 LTS 版本,如 22.04 LTS)。注意: 不要选择带版本号的预览版 (如 Ubuntu 24.04 LTS),除非你明确需要。 -
点击“获取”或“安装”按钮。
-
https://placehold.co/600x400/EEE/CCC?text=Microsoft+Store+Ubuntu+%E5%AE%89%E8%A3%85%E6%88%AA%E5%9B%BE
-
-
等待下载和安装完成。安装完成后,可以在开始菜单找到“Ubuntu”图标。
步骤 4:启动 Ubuntu 并完成初始化
-
在开始菜单中找到并点击 Ubuntu 图标。
-
首次启动需要等待片刻(初始化环境),然后会提示你:
bash
Installing, this may take a few minutes... Please create a default UNIX user account. The username does not need to match your Windows username. For more information visit: https://aka.ms/wslusers Enter new UNIX username: [输入你想要的用户名,小写字母开头,如 yourname] New password: [输入密码(输入时不会显示字符)] Retype new password: [再次输入相同密码]
-
重要提示:
-
这个用户名和密码是 Ubuntu 系统的管理员账号 (
sudo用户),与你的 Windows 账号密码无关。 -
请牢记这个密码!以后执行管理员命令 (
sudo) 时需要使用它。
-
-
-
初始化完成后,你将看到一个类似
yourname@DESKTOP-XXXXXX:~$的命令行提示符。恭喜!Ubuntu 已在 WSL2 中成功运行!
四、基础使用与重要技巧
-
启动 Ubuntu:
-
方法 1:开始菜单 > 点击“Ubuntu”图标。
-
方法 2:在 Windows 终端 (推荐) 或 PowerShell/CMD 中输入
wsl或ubuntu命令。
-
-
退出 Ubuntu:
-
在 Ubuntu 终端中输入
exit或按Ctrl + D。
-
-
文件系统互访:
-
在 Ubuntu 中访问 Windows 文件:路径为
/mnt/下。例如你的 C 盘就是/mnt/c/。bash
ls /mnt/c/Users/你的Windows用户名/Desktop # 查看你的Windows桌面文件
-
在 Windows 中访问 Ubuntu 文件:
-
打开文件资源管理器,在地址栏输入
wsl$Ubuntu(或wsl$查看所有 WSL 发行版)。 -
你的 Ubuntu 家目录 (
/home/你的用户名) 通常就在里面。注意: 不要直接在此修改 Linux 系统文件(如/etc,/var,/usr),可能导致权限问题或损坏系统。
-
-
-
更新软件包:
-
刚安装完系统,建议先更新软件包列表并升级已安装的包:
bash
sudo apt update && sudo apt upgrade -y
-
输入你在步骤 4 设置的密码(输入时不显示)。
-
sudo: 以管理员权限执行命令。 -
apt update: 更新可用的软件包列表。 -
apt upgrade -y: 升级所有可升级的软件包 (-y表示自动确认)。
-
-
-
安装常用工具:
bash
sudo apt install -y build-essential git curl wget tree
-
管理 WSL (在 PowerShell 或 CMD 中运行):
-
wsl --list --verbose(wsl -l -v):列出已安装的发行版及其状态和 WSL 版本。 -
wsl --shutdown:立即停止所有正在运行的 WSL 发行版和虚拟机。 -
wsl --terminate:停止指定的发行版(如wsl --terminate Ubuntu)。 -
wsl --export Ubuntu ubuntu_backup.tar:导出 Ubuntu 发行版为备份文件。 -
wsl --import NewUbuntu C:path ostore ubuntu_backup.tar:导入备份文件创建新发行版。
-
五、常见问题与解决方案
-
安装 Ubuntu 后启动提示
0x800701bc错误:-
原因:WSL2 内核组件未正确安装或已损坏。
-
解决:
-
访问 Manual installation steps for older versions of WSL | Microsoft Learn 下载最新的 WSL2 Linux 内核更新包。
-
运行下载的
.msi文件进行安装。 -
在 PowerShell 中执行
wsl --update更新 WSL。 -
重启电脑,再尝试启动 Ubuntu。
-
-
-
wsl --set-default-version 2提示无效版本 2:-
原因:没有安装 WSL2 内核更新包。
-
解决:同问题 1,下载并安装 WSL2 Linux 内核更新包。
-
-
Ubuntu 启动后卡住无反应:
-
可能原因:网络问题或首次初始化较慢。
-
尝试:耐心等待几分钟。如果长时间无响应,按
Ctrl + C中断,然后尝试重启 Ubuntu 或电脑。
-
-
忘记 Ubuntu 密码:
-
解决:
-
在 PowerShell 中运行
ubuntu config --default-user root(将默认用户临时设为root)。 -
启动 Ubuntu,此时以
root身份登录(无密码)。 -
执行
passwd 你的用户名重置密码。 -
退出 Ubuntu (
exit)。 -
在 PowerShell 中运行
ubuntu config --default-user 你的用户名恢复默认用户。
-
-
-
如何彻底卸载 Ubuntu/WSL:
-
在 PowerShell 中运行
wsl --unregister Ubuntu(删除发行版)。 -
在“设置” > “应用” > “应用和功能”中搜索
Ubuntu,点击卸载。 -
(可选) 在“控制面板” > “程序” > “启用或关闭 Windows 功能”中取消勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”并重启(会禁用所有 WSL)。
-
六、进阶提示与最佳实践
-
使用 Windows Terminal:
-
强烈推荐从 Microsoft Store 安装 Windows Terminal!它提供多标签页、主题、分窗等功能,是管理 WSL、PowerShell、CMD 的最佳终端。
-
安装后,可以将其设置为默认终端。
-
-
VS Code + WSL 开发:
-
安装 VS Code 的 Remote - WSL 扩展。
-
在 Ubuntu 终端中进入项目目录,输入
code .,即可直接在 Windows 上用 VS Code 打开并编辑 Linux 环境下的文件,享受无缝开发体验。
-
-
备份你的 WSL 环境:
-
定期使用
wsl --export命令备份发行版,防止意外损坏或配置丢失。
-
-
WSL2 的内存/CPU 限制:
-
WSL2 默认会动态分配内存和 CPU。如果资源占用过高,可在用户目录 (如
C:UsersYourName) 下创建.wslconfig文件进行限制:ini
[wsl2] memory=4GB # 限制最大内存为 4GB processors=2 # 限制使用 2 个 CPU 核心 swap=1GB # 限制交换空间为 1GB
-
-
图形界面 (GUI) 应用:
-
WSL2 默认只支持命令行。如需运行带图形界面的 Linux 程序 (如 GIMP, Firefox):
-
确保 Windows 已安装 WSLg (Windows 11 和 Win10 21H2+ 通常已内置)。
-
在 Ubuntu 中安装图形应用 (如
sudo apt install gedit -y)。 -
直接在 WSL 命令行输入应用名 (如
gedit),应用窗口会自动在 Windows 桌面上弹出。
-
-
恭喜你!
🎉 你已成功在 WSL2 上安装了 Ubuntu!现在,你拥有了一个强大且高效的 Linux 开发环境,可以学习 Linux 命令、进行软件开发、运行服务器软件,而无需离开 Windows 的舒适区。尽情探索 Linux 世界的精彩吧!











