WSL2安装Ubuntu及环境配置教程

本文详细介绍了在Windows系统上通过WSL2快速、可靠部署Ubuntu开发环境的五种实用方法，从新手友好的`wsl --install`一键安装，到手动启用组件、跨盘迁移、离线安装及环境验证全流程，覆盖系统版本兼容性、磁盘空间优化、网络受限场景等常见痛点，并提供清晰可复现的操作步骤与故障排查要点，帮助开发者避开安装失败、版本错配、启动异常等典型陷阱，高效构建稳定可用的Linux开发环境。

如果您希望在Windows系统中通过WSL2快速部署Ubuntu作为开发环境，但不确定从何处开始或遇到安装失败、版本不匹配、启动异常等问题，则很可能是由于系统组件未启用、内核未更新或发行版安装方式不当所致。以下是多种可靠且经验证的部署方法：

一、使用wsl --install一键部署（推荐新手）

该命令由微软官方提供，适用于Windows 11 22H2+或Windows 10 2004+且已启用虚拟化的系统，可自动完成功能启用、内核更新、默认版本设置及Ubuntu LTS安装全流程。

1、以管理员身份打开PowerShell或Windows Terminal。

2、执行命令：wsl --install。

3、等待命令自动下载并安装WSL2内核与Ubuntu（默认为最新LTS，如Ubuntu 24.04）。

4、重启计算机使更改生效。

5、重启后首次启动Ubuntu，按提示创建UNIX用户名和密码。

二、分步手动启用+指定发行版安装

适用于需精确控制安装版本、目标磁盘位置或网络受限环境，避免默认安装路径占用C盘空间。

1、以管理员身份打开PowerShell。

2、依次执行以下两条启用命令：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart。

3、执行：dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart。

4、重启计算机。

5、重启后，在PowerShell中运行：wsl --set-default-version 2。

6、执行：wsl --install -d Ubuntu-22.04（可替换为Ubuntu-20.04或Ubuntu-24.04）。

三、从Microsoft Store安装并迁移至非系统盘

当默认安装路径（C:\Users\...\AppData\Local\Packages\）磁盘空间紧张时，可通过导出-导入机制将Ubuntu实例完整迁移到D盘等其他分区，保留全部配置与数据。

1、启动已安装的Ubuntu，运行wsl -l -v确认发行版名称（如Ubuntu-22.04）。

2、在PowerShell中执行：wsl --shutdown确保子系统完全停止。

3、执行导出命令：wsl --export Ubuntu-22.04 D:\wsl_backup\ubuntu2204.tar。

4、创建目标目录：mkdir D:\wsl\ubuntu2204。

5、执行导入：wsl --import Ubuntu2204 D:\wsl\ubuntu2204 D:\wsl_backup\ubuntu2204.tar。

6、注销原实例：wsl --unregister Ubuntu-22.04。

7、启动新实例：wsl -d Ubuntu2204。

四、离线安装Ubuntu发行版（无网络环境适用）

适用于企业内网或断网服务器场景，需提前在联网设备下载Ubuntu Appx包，并通过本地路径安装。

1、在有网络的Windows设备上访问：https://github.com/microsoft/WSL/releases，下载对应Ubuntu版本的.appx文件（如Ubuntu_2204.1.7.0_x64.appx）。

2、将文件复制至目标机器任意目录（如D:\wsl\）。

3、以管理员身份打开PowerShell，进入该目录，执行：Add-AppxPackage .\Ubuntu_2204.1.7.0_x64.appx。

4、安装完成后，首次运行会弹出终端，按提示初始化用户。

5、若启动报错0x800701bc，需先执行：wsl --update并重启。

五、验证与基础环境就绪检查

无论采用哪种安装方式，成功部署后必须验证核心组件是否正常工作，确保后续开发流程不受阻断。

1、在PowerShell中运行：wsl --list --verbose，确认状态为Running且VERSION列为2。

2、启动Ubuntu终端，执行：cat /etc/os-release，核对ID与VERSION_ID是否匹配预期版本。

3、运行：uname -r，输出应包含WSL2字样，例如5.15.90.1-microsoft-standard-WSL2。

4、执行：sudo apt update && sudo apt upgrade -y，确认软件源连通性与基础包可更新。

5、检查Python与pip版本：python3 --version && pip3 --version。

本篇关于《WSL2安装Ubuntu及环境配置教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！