Windows 11上使用WSL 2安装与配置Ubuntu开发环境

1. 项目概述

Windows Subsystem for Linux（WSL）是微软在Windows 10和Windows 11中引入的革命性功能，它允许用户在Windows系统上原生运行Linux环境。作为一名长期使用WSL进行开发的工程师，我发现这彻底改变了Windows平台的开发体验。不同于传统的虚拟机方案，WSL提供了近乎原生的性能，同时保持了与Windows系统的深度集成。

在Windows 11上安装Ubuntu通过WSL，开发者可以获得一个完整的Linux环境，能够运行绝大多数Linux命令行工具和应用程序，包括bash、apt、vim等，而无需双系统启动或性能损耗较大的虚拟机。这对于需要同时使用Windows应用和Linux工具链的开发者来说，是一个完美的解决方案。

2. 环境准备与安装

2.1 系统要求检查

在开始安装前，需要确认你的Windows 11系统满足以下要求：

• Windows 11版本21H2或更高版本（内部版本号22000或更高）
• 64位处理器
• 已启用BIOS/UEFI中的虚拟化支持
• 至少4GB内存（推荐8GB或更多）

可以通过Win+R运行winver命令来检查Windows版本。如果系统版本较旧，建议通过Windows Update升级到最新版本。

2.2 启用WSL功能

WSL功能默认是关闭的，需要通过管理员权限的PowerShell启用：

1. 右键点击开始菜单，选择"Windows终端(管理员)"
2. 在打开的PowerShell窗口中输入以下命令：

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

3. 执行完成后，重启计算机使更改生效

注意：如果你计划使用WSL 2（推荐），还需要确保已安装WSL 2内核更新包。可以从微软官网下载最新版本的WSL 2内核更新。

2.3 安装Ubuntu发行版

Windows 11提供了极其简便的Ubuntu安装方式。只需在管理员权限的PowerShell中执行：

wsl --install -d Ubuntu

这个命令会自动完成以下操作：

1. 启用WSL功能（如果尚未启用）
2. 将WSL 2设置为默认版本
3. 下载并安装最新的Ubuntu LTS发行版
4. 设置初始用户账户

安装过程可能需要一些时间，具体取决于你的网络速度。完成后，系统会提示你为Ubuntu创建一个用户名和密码。

3. 初始设置与配置

3.1 首次启动与用户设置

安装完成后，你可以通过以下几种方式启动Ubuntu：

1. 在开始菜单中搜索"Ubuntu"并点击
2. 在PowerShell或命令提示符中输入wsl或ubuntu
3. 在Windows终端中选择Ubuntu标签页

首次启动时，系统会要求你创建一个新的UNIX用户名和密码。这个账户将是Ubuntu子系统的管理员账户（具有sudo权限）。

提示：这个密码不需要与你的Windows账户密码相同，但建议设置一个强密码，因为在使用sudo时会需要输入。

3.2 更新系统软件包

新安装的Ubuntu系统应该首先更新软件包列表和已安装的软件包。在Ubuntu终端中执行：

sudo apt update && sudo apt upgrade -y

这个命令会：

1. 更新软件包列表（apt update）
2. 升级所有可升级的软件包（apt upgrade）
3. -y参数自动确认所有提示

3.3 配置WSL版本

检查当前Ubuntu实例运行的WSL版本：

wsl -l -v

如果显示为WSL 1，可以将其升级到WSL 2以获得更好的性能和完全的系统调用兼容性：

wsl --set-version Ubuntu 2

要将WSL 2设置为所有新安装发行版的默认版本：

wsl --set-default-version 2

4. 高级配置与优化

4.1 文件系统互操作性

WSL的一个强大特性是Windows和Linux文件系统之间的无缝互操作：

• 在Windows中访问Linux文件：\\wsl$\Ubuntu\
• 在Linux中访问Windows文件：/mnt/c/（对应C盘）

重要提示：建议不要在Linux子系统中直接修改Windows文件，特别是通过Git管理的项目文件，这可能导致权限和行尾符问题。最佳实践是将项目文件放在Linux文件系统中（如~/projects）。

4.2 内存与CPU限制配置

默认情况下，WSL 2会使用最多50%的物理内存和80%的CPU核心。对于开发环境，可能需要调整这些限制。

创建或编辑%USERPROFILE%\.wslconfig文件，添加以下内容：

[wsl2] memory=8GB # 限制最大内存使用量 processors=4 # 限制CPU核心数 localhostForwarding=true

重启WSL使更改生效：

wsl --shutdown

4.3 图形界面支持（可选）

虽然WSL主要面向命令行使用，但也可以通过X Server实现图形界面支持：

1. 在Windows上安装X Server软件，如VcXsrv或X410
2. 在Ubuntu中安装图形应用，例如：

sudo apt install gedit gnome-calculator

3. 在Ubuntu中设置DISPLAY环境变量：

export DISPLAY=$(awk '/nameserver / {print $2; exit}' /etc/resolv.conf 2>/dev/null):0

5. 日常使用技巧

5.1 常用命令参考

Windows命令	WSL等效命令	说明
dir	ls	列出目录内容
cd	cd	切换目录
type	cat	查看文件内容
copy	cp	复制文件
move	mv	移动/重命名文件
del	rm	删除文件
ipconfig	ifconfig	网络配置
ping	ping	网络连通性测试

5.2 与Windows工具的集成

WSL可以与Windows开发工具无缝集成：

1. VS Code：安装"Remote - WSL"扩展，可以直接在WSL环境中开发和调试代码
2. Docker：安装Docker Desktop并启用WSL 2后端，可以在WSL中使用Docker
3. Windows Terminal：配置为默认终端，提供更好的标签页和自定义支持

5.3 备份与恢复

WSL实例可以方便地导出和导入：

1. 导出Ubuntu实例：

wsl --export Ubuntu ubuntu_backup.tar

2. 导入备份的实例：

wsl --import Ubuntu_New C:\wsl\ubuntu_new ubuntu_backup.tar

6. 常见问题解决

6.1 安装问题排查

问题1：wsl --install命令执行后没有反应

解决方案：

1. 确保已以管理员身份运行PowerShell
2. 检查Windows功能是否已启用：

Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

3. 手动下载并安装WSL 2内核更新包

问题2：安装过程中卡在0%

解决方案：

1. 使用以下命令手动下载发行版：

wsl --install --web-download -d Ubuntu

2. 如果仍然失败，尝试更换网络环境或使用VPN

6.2 网络问题

问题：WSL 2中无法访问互联网

解决方案：

1. 检查Windows防火墙设置
2. 重置WSL网络：

wsl --shutdown netsh winsock reset

3. 检查/etc/resolv.conf文件中的DNS设置

6.3 性能优化

问题：文件操作速度慢

解决方案：

1. 将项目文件放在Linux文件系统中（如~/projects），而非/mnt/c/
2. 对于Git仓库，使用以下配置改善性能：

git config --global core.ignorecase true git config --global core.fileMode false

7. 进阶使用场景

7.1 多发行版管理

WSL支持同时安装多个Linux发行版：

1. 查看可用发行版列表：

wsl --list --online

2. 安装其他发行版，如Debian：

wsl --install -d Debian

3. 设置默认发行版：

wsl --set-default Debian

7.2 使用GPU加速

WSL 2支持GPU加速，适合机器学习开发：

1. 确保已安装最新的NVIDIA或AMD显卡驱动
2. 在Ubuntu中安装CUDA工具包：

sudo apt install nvidia-cuda-toolkit

3. 验证GPU访问：

nvidia-smi

7.3 容器化开发

结合Docker和WSL创建高效的开发环境：

1. 安装Docker Desktop并启用WSL 2后端
2. 在Ubuntu中安装Docker客户端：

sudo apt install docker.io

3. 配置Docker客户端连接到Windows的Docker守护进程：

export DOCKER_HOST=tcp://localhost:2375

经过几个月的实际使用，我发现WSL 2上的Ubuntu环境已经能够满足我90%的开发需求。特别是对于全栈开发者，可以在Windows上使用Visual Studio开发前端，同时在WSL中运行后端服务，这种无缝切换的体验是传统虚拟机无法比拟的。一个小技巧是使用Windows Terminal的拆分窗格功能，可以同时显示PowerShell和Ubuntu终端，极大提高了工作效率。