Windows WSL2 环境搭建指南。涵盖 Windows 10/11 系统要求确认，通过 PowerShell 一键或手动安装 WSL2 及 Ubuntu 22.04 LTS。详解存储位置迁移至非系统盘方法，配置 .wslconfig 优化内存与 CPU 资源，设置 /etc/wsl.conf 启用 systemd 及网络选项。提供常用命令速查表，解决 systemd 无效、网络异常、内存占用过高及 GUI 应用运行等常见问题。支持 Docker 嵌套虚拟化及 VS Code 集成开发，助力开发者高效构建跨平台 Linux 环境。
本指南为 Windows 10 和 Windows 11 用户提供从零开始搭建 WSL2 环境的详细步骤，涵盖安装 Ubuntu 22.04、自定义存储位置、性能优化以及常见问题排查。
在选择运行 Linux 环境时，WSL2（Windows Subsystem for Linux 2）与 VirtualBox、VMware 等传统虚拟机相比具有显著优势。以下是选择 WSL2 的主要理由：
autoMemoryReclaim 释放内存，而 VirtualBox 通常需要预分配固定内存。/mnt/），并提供高性能的文件共享，而 VirtualBox 需要配置共享文件夹，性能较低。localhost 端口无缝转发，方便开发和测试，而 VirtualBox 需要复杂网络配置。wsl --install 快速部署，相比 VirtualBox 的繁琐安装和配置过程更简单。apt 维护，管理成本低。VirtualBox 需要手动更新虚拟机镜像和扩展包。.vhdx）动态扩展存储，占用空间小，而 VirtualBox 虚拟机镜像通常占用较大固定空间。| 特性 | WSL2 | VirtualBox |
|---|---|---|
| 性能 | 高（轻量级虚拟化） | 中等（完整虚拟化） |
| Windows 集成 | 无缝（文件、端口、命令行） | 有限（需共享文件夹、网络配置） |
| GUI 支持 | 原生支持（Windows 11 WSLg） | 需要额外配置 X 服务器或图形界面 |
| 开发工具集成 | 优秀（VS Code、Docker 等） | 一般（需手动配置） |
| 管理复杂度 | 低（一键安装、自动更新） | 高（手动配置、更新） |
| 存储占用 | 动态扩展（小） | 固定分配（较大） |
结论：对于开发者、学生或需要在 Windows 上快速运行 Linux 环境的个人，WSL2 提供更高效、便捷的体验。对于需要完整虚拟化或特殊硬件模拟的场景，VirtualBox 可能更适合。
在安装 WSL2 之前，需确保你的 Windows 系统满足最低要求。
Win + R，输入 winver，回车。若版本不符合要求：
提示：建议备份重要数据后再升级系统，以防意外情况。
WSL2 提供两种安装方式：一键安装（推荐新手）和手动安装（适合需要自定义的用户）。
执行以下命令：
wsl --install
注意：若命令未自动安装 Ubuntu，可在后续步骤手动安装 Ubuntu 22.04.
适合需要精确控制安装过程的高级用户。
设置 WSL2 为默认版本：
wsl --set-default-version 2
重启电脑：
shutdown /r /t 0
启用必要功能： 以管理员身份运行 PowerShell，执行：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
提示：若需确认 WSL 是否安装成功，可运行
wsl --version检查版本信息。
Ubuntu 22.04 LTS 是长期支持版本，稳定且适合大多数开发场景。以下提供两种安装方式。
在 PowerShell 中运行：
wsl --install -d Ubuntu-22.04
注意：用户名和密码仅用于 Ubuntu 内部，与 Windows 账户无关。若 Microsoft Store 访问受限，推荐使用命令行方式。
WSL2 的虚拟硬盘文件（.vhdx）默认占用系统盘空间，可能导致 C 盘空间不足。以下介绍如何查看默认存储位置并迁移到其他磁盘。
Ubuntu 22.04 的文件默认位于：
C:\Users\<用户名>\AppData\Local\Packages\CanonicalGroupLimited...UbuntuonWindows_...
.vhdx 的虚拟硬盘文件，存储 Ubuntu 的完整文件系统。通过导出和导入操作，可将 Ubuntu 迁移到其他磁盘（如 D 盘）。
.tar 文件，存储在 D:\WSL 目录。D:\WSL\Ubuntu2204 目录，确保使用 WSL2。验证迁移：
wsl -l -v
导入到新位置：
wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 D:\WSL\Ubuntu2204_backup.tar --version 2
注销旧发行版：
wsl --unregister Ubuntu-22.04
导出 Ubuntu 发行版：
wsl --export Ubuntu-22.04 D:\WSL\Ubuntu2204_backup.tar
提示：迁移后，建议定期备份
.tar文件以便恢复。若需调整虚拟硬盘大小，可使用wsl --manage命令（Windows 11 24H2 及以上支持）。
以下是管理 WSL2 的核心命令，建议收藏以便随时参考。
| 命令 | 说明 |
|---|---|
wsl --list / -l | 列出所有已安装的发行版 |
wsl --list --verbose / -l -v | 显示详细信息（包括版本和默认发行版） |
wsl --set-version <发行版名> 2 | 将指定发行版切换到 WSL2 |
wsl --set-default <发行版名> | 设置默认运行的发行版 |
wsl --set-default-version 2 | 设置新安装的发行版默认使用 WSL2 |
wsl --shutdown | 关闭所有运行中的 WSL 实例 |
wsl --terminate <发行版名> | 强制终止指定发行版 |
wsl --unregister <发行版名> | 注销并删除指定发行版 |
wsl --export <发行版名> <文件路径> | 导出发行版到指定路径 |
wsl --import <发行版名> <路径> <文件> | 导入发行版到指定位置 |
提示：使用
wsl --help可查看完整命令列表。
.wslconfigWSL2 的性能可以通过全局配置文件 .wslconfig 进行优化，文件位于：
C:\Users\<用户名>\.wslconfig
若文件不存在，需手动创建。
[wsl2]
memory=6GB # 限制最大内存使用量
processors=4 # 指定 CPU 核心数
swap=8GB # 交换空间大小
swapFile=D:\WSL\swap.vhdx # 自定义 swap 文件路径
autoMemoryReclaim=true # 自动回收未使用内存
localhostForwarding=true # 启用 localhost 端口转发
guiApplications=true # 启用 WSLg（GUI 应用支持）
gpu=true # 启用 GPU 加速（需支持的 GPU 驱动）
dns=8.8.8.8 # 使用 Google DNS
networkingMode=mirrored # 启用镜像网络模式（支持 IPv6）
firewall=true # 启用 WSL 防火墙集成
autoProxy=true # 自动使用 Windows 代理
nestedVirtualization=true # 启用嵌套虚拟化（适合运行 Docker 等）
| 参数 | 说明 |
|---|---|
memory | 限制 WSL2 最大内存，避免占用过多宿主机资源。 |
processors | 指定分配的 CPU 核心数，建议设为物理核心数的一半。 |
swap | 设置交换空间大小，推荐为内存的 1-2 倍。 |
swapFile | 自定义交换文件路径，避免占用 C 盘。 |
autoMemoryReclaim | 启用后定期回收未使用内存，提升宿主机性能。 |
localhostForwarding | 允许 WSL2 与 Windows 共享 localhost 端口。 |
guiApplications | 启用 WSLg，支持运行 Linux GUI 应用（Windows 11 独有）。 |
gpu | 启用 GPU 加速，适合机器学习或图形密集型任务。 |
dns | 自定义 DNS 服务器，解决网络解析问题。 |
networkingMode | 设置为 mirrored 支持双栈网络（IPv4/IPv6）。 |
firewall | 启用防火墙集成，提升安全性。 |
autoProxy | 自动同步 Windows 代理设置，适合科学上网场景。 |
nestedVirtualization | 启用嵌套虚拟化，支持在 WSL2 内运行虚拟机或容器。 |
.wslconfig 文件。执行：
wsl --shutdown
/etc/wsl.conf/etc/wsl.conf 是 WSL2 发行版内部的配置文件，用于控制挂载、网络和启动行为。
[boot]
systemd=true
[automount]
enabled=true
root=/mnt/
options="metadata,umask=22,fmask=11"
[network]
generateHosts=true
generateResolvConf=false
[interop]
enabled=true
appendWindowsPath=true
[user]
default=<你的用户名>
| 节 | 键 | 说明 |
|---|---|---|
[boot] | systemd | 启用 systemd（需 Windows 11 22H2 或更高）。 |
[automount] | enabled | 启用 Windows 磁盘自动挂载。 |
[automount] | root | 设置挂载点路径，默认 /mnt/。 |
[automount] | options | 挂载选项，如 metadata 启用文件权限映射。 |
[network] | generateHosts | 是否生成 /etc/hosts 文件。 |
[network] | generateResolvConf | 是否自动生成 /etc/resolv.conf（设为 false 可自定义 DNS）。 |
[interop] | enabled | 启用 Windows 和 WSL 之间的互操作性。 |
[interop] | appendWindowsPath | 将 Windows PATH 添加到 WSL 环境变量。 |
[user] | default | 设置默认登录用户。 |
保存后，重启 WSL：
wsl --shutdown
在 Ubuntu 中编辑 /etc/wsl.conf：
sudo nano /etc/wsl.conf
提示：若需自定义 DNS，可手动编辑
/etc/resolv.conf，并确保generateResolvConf=false。
以下是 WSL2 使用中的常见问题及解决方法。
原因：Windows 版本不支持 systemd 或配置错误。 解决：
winver 检查）。/etc/wsl.conf 中 [boot] systemd=true。wsl --shutdown 后重试。原因：DNS 解析失败或网络模式配置错误。 解决：
清理 Windows DNS 缓存：
ipconfig /flushdns
wsl --shutdown
在 .wslconfig 中设置：
dns=8.8.8.8
networkingMode=mirrored
原因：WSL2 默认动态分配内存，可能占用过多资源。 解决：
wsl --shutdown 释放内存。在 .wslconfig 中限制内存：
memory=4GB
autoMemoryReclaim=true
步骤：
关闭 WSL：
wsl --shutdown
注销发行版：
wsl --unregister Ubuntu-22.04
原因：Windows 11 配置或驱动问题。 解决：
.wslconfig 中 guiApplications=true）。VcXsrv）作为备用。gedit、firefox）。安装示例：
sudo apt update
sudo apt install firefox
.wslconfig 中 nestedVirtualization=true）。示例：
curl -fsSL https://code-server.dev/install.sh | sh code-server
一页速查，涵盖安装、管理和优化，适合打印或保存为 PDF。
# 一键安装 WSL2
wsl --install
# 安装 Ubuntu 22.04
wsl --install -d Ubuntu-22.04
# 查看发行版
wsl -l -v
# 设置默认 WSL2
wsl --set-default-version 2
# 关闭 WSL
wsl --shutdown
.wslconfig路径：C:\Users\<用户名>\.wslconfig
[wsl2]
memory=6GB
processors=4
swap=8GB
autoMemoryReclaim=true
networkingMode=mirrored
guiApplications=true
/etc/wsl.conf[boot]
systemd=true
[automount]
enabled=true
options="metadata"
[network]
generateResolvConf=false
/etc/wsl.conf。memory=4GB 和 autoMemoryReclaim=true。networkingMode=mirrored 和 dns=8.8.8.8。WSL2 是一个强大的工具，将 Linux 的灵活性与 Windows 的易用性结合，为开发者提供了高效的跨平台开发环境。通过本文的指南，你可以：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online