Windows 使用 WSL 安装 Ubuntu 详细教程本文详细介绍如何在 Windows 系统上通过 WSL适用于 Linux 的 Windows 子系统安装 Ubuntu包含完整的命令行操作步骤。欢迎点赞收藏加关注关注我的咸鱼用户代码跑通pytorch,一个金鱼图像。你的支持是我更新的动力。一、前置条件操作系统Windows 10版本 2004 及以上或 Windows 11权限需要管理员权限运行 PowerShell二、检查 WSL 状态打开PowerShell管理员运行以下命令检查 WSL 是否已安装wsl--status如果提示未安装适用于 Linux 的 Windows 子系统说明需要安装。三、安装步骤方法一一键安装推荐直接执行以下命令会自动完成 WSL 功能启用 Ubuntu 下载安装wsl--install-d Ubuntu该命令会自动完成启用 WSL 功能启用虚拟机平台下载并安装 Linux 内核将 WSL 2 设为默认版本下载并安装 Ubuntu注意执行后系统会提示“请求的操作成功。直到重新启动系统前更改将不会生效。”此时需要重启电脑。方法二手动安装旧版 Windows 10如果wsl --install不可用需要手动执行以下步骤# 1. 启用 WSL 功能dism.exe/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart# 2. 启用虚拟机平台dism.exe/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart# 3. 重启电脑重启后继续执行# 4. 设置默认 WSL 版本为 2wsl--set-default-version 2# 5. 安装 Ubuntuwsl--install-d Ubuntu四、查看可用发行版如果想查看所有可安装的 Linux 发行版运行wsl--list--online输出示例NAMEFRIENDLY NAMEUbuntuUbuntuUbuntu-24.04Ubuntu 24.04 LTSUbuntu-22.04Ubuntu 22.04 LTSUbuntu-20.04Ubuntu 20.04 LTSDebianDebian GNU/Linuxkali-linuxKali Linux RollingarchlinuxArch LinuxopenSUSE-TumbleweedopenSUSE Tumbleweed……安装指定版本示例wsl--install-d Ubuntu-24.04五、自定义安装目录安装到 D 盘默认情况下wsl --install -d Ubuntu会将系统安装到 C 盘%LOCALAPPDATA%\Packages\下。如果想安装到其他目录如D:\Software\wsl可以使用以下方法方法一使用 --location 参数一键安装推荐WSL 支持通过--location参数直接指定安装目录最简单的方式wsl--install-d Ubuntu--location D:\Software\wsl该命令会自动完成下载并安装 Ubuntu将虚拟磁盘文件ext4.vhdx存储到D:\Software\wsl目录首次安装完成后会提示设置用户名和密码注意如果 WSL 功能尚未启用首次执行后需要重启电脑重启后再次运行该命令即可开始下载安装 Ubuntu。方法二先安装再迁移适用于已经通过wsl --install -d Ubuntu安装到 C 盘想迁移到 D 盘的情况。# 1. 确认 Ubuntu 已安装并完成初始配置设置好用户名密码wsl-l-v# 2. 关闭 WSLwsl--shutdown# 3. 导出当前 Ubuntu 为备份文件wsl--export Ubuntu D:\Software\ubuntu-backup.tar# 4. 注销原来的 Ubuntu会删除 C 盘上的数据wsl--unregister Ubuntu# 5. 创建目标目录并导入到新位置mkdir D:\Software\wsl wsl--import Ubuntu D:\Software\wsl D:\Software\ubuntu-backup.tar# 6. 设置默认登录用户替换 你的用户名 为你之前设置的用户名ubuntu config--default-user 你的用户名# 7. 删除备份文件可选Remove-ItemD:\Software\ubuntu-backup.tar安装验证# 确认安装位置和版本wsl-l-v确认D:\Software\wsl目录下存在ext4.vhdx文件说明安装成功。提示方法一使用--location安装的发行版与默认安装体验一致会出现在开始菜单中。方法二通过--import导入的发行版不会出现在开始菜单需要通过wsl -d Ubuntu或 Windows Terminal 启动。六、重启后首次配置重启电脑后在开始菜单中搜索Ubuntu并打开首次启动会自动完成 Ubuntu 的安装配置需等待几分钟系统会提示设置用户名和密码设置完成后即可使用 Ubuntu 终端如果重启后 Ubuntu 没有自动出现在 PowerShell 中再次运行wsl --install -d Ubuntu此时会直接下载安装镜像不再需要重启。七、常用 WSL 命令命令说明wsl进入默认 Linux 发行版wsl -l -v查看已安装的发行版和 WSL 版本wsl --list --online查看可安装的发行版列表wsl --update更新 WSL 内核wsl --set-default-version 2设置默认 WSL 版本为 2wsl --set-default Ubuntu设置默认发行版wsl --shutdown关闭所有 WSL 实例wsl --terminate Ubuntu关闭指定发行版wsl --unregister Ubuntu卸载指定发行版数据会丢失wsl --export Ubuntu D:\backup.tar导出发行版备份wsl --import Ubuntu2 D:\wsl D:\backup.tar从备份导入发行版八、常见问题Q1安装报错0x80370102需要在 BIOS 中开启虚拟化技术Intel VT-x / AMD-V。Q2安装报错0x800701bc需要手动下载安装 WSL2 Linux 内核更新包下载地址https://aka.ms/wsl2kernel下载后双击安装然后重试Q3WSL 版本为 1如何升级到 2# 查看当前版本wsl-l-v# 转换为 WSL 2wsl--set-versionUbuntu 2Q4如何在 VS Code 中使用 WSL安装 VS Code 扩展WSLRemote - WSL按CtrlShiftP输入WSL: Connect to WSL即可在 VS Code 中直接操作 Linux 文件系统Q5Windows 和 Ubuntu 之间如何访问文件在 Ubuntu 中访问 Windows 文件/mnt/c/对应 C 盘在 Windows 中访问 Ubuntu 文件资源管理器地址栏输入\\wsl$\Ubuntu九、总结完整安装流程检查 WSL 状态 → wsl --install -d Ubuntu → 重启电脑 → 打开 Ubuntu → 设置用户名密码 → 完成WSL 2 相比 WSL 1 拥有完整的 Linux 内核、更好的文件系统性能和完整的系统调用兼容性推荐使用 WSL 2。作者环境Windows 11 WSL 2 Ubuntu如果本文对你有帮助欢迎点赞收藏