WSL2安装失败主因是Windows功能未启用，需以管理员身份运行PowerShell执行两条Enable-WindowsOptionalFeature命令并重启；版本需≥19041，BIOS虚拟化须开启；导入镜像要指定--version 2并配置默认用户及/etc/wsl.conf。
WSL2 安装失败提示“适用于 Linux 的 Windows 子系统已关闭”
这是 wsl2 启用前最常卡住的第一步，本质是 windows 功能没打开。不是权限问题，也不是网络问题，就是系统级开关没拨。
必须以管理员身份运行 PowerShell，执行：
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart和
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart。注意两个命令缺一不可，
VirtualMachinePlatform 是 WSL2 的底层依赖，只开子系统功能只会默认启用 WSL1。
- 执行完必须重启电脑，不重启
wsl --set-default-version 2会报错 - Windows 版本低于 19041（即 2004）不支持 WSL2，别硬试
- 某些 OEM 预装系统（如部分戴尔/惠普笔记本）可能禁用了 BIOS 中的虚拟化（VT-x/AMD-V），需进 BIOS 手动开启
wsl --import 导入镜像后无法启动，报错“Failed to launch Ubuntu”
常见于从第三方下载 rootfs.tar.gz 后直接 wsl --import，但忽略了发行版初始化逻辑。WSL 并不自动创建用户、设置密码或配置 /etc/passwd，它只是把文件解压进目录，然后试图用默认 shell 启动——而很多精简镜像压根没配 /bin/bash 或用户 entrypoint。
导入时务必指定默认用户，例如：
wsl --import MyUbuntu C:\wsl\MyUbuntu C:\temp\ubuntu-22.04-rootfs.tar.gz --version 2，然后立即运行：
wsl -d MyUbuntu -u root进入 root 环境，手动执行：
useradd -m -s /bin/bash myuser && passwd myuser，再编辑
/etc/wsl.conf 加入：[user]<br>default=myuser
- 不要跳过
--version 2参数，否则默认用 WSL1 导入，后续升级麻烦 -
wsl --import不会自动运行apt update或修复 locale，首次启动后建议手动运行apt update && apt install -y locales && locale-gen en_US.UTF-8 - 镜像 tar 包里若不含
/init或/sbin/init，WSL 可能无法识别为合法发行版，优先选官方导出的 tar（如从已运行的 WSL 实例中用wsl --export生成）
导入后中文乱码、时区错误、DNS 解析失败
这些不是镜像本身的问题，而是 WSL2 启动时未读取 Windows 主机的环境上下文。WSL1 能自动继承，但 WSL2 是轻量虚拟机，默认隔离更彻底。
关键在 /etc/wsl.conf：必须存在且至少包含以下内容：
[boot]<br>command = "service dbus start"<br>[network]<br>generateHosts = true<br>generateResolvConf = true<br>[locale]<br>LANG = "en_US.UTF-8"。其中
generateResolvConf = true 让 WSL 自动从 Windows 获取 DNS；generateHosts = true 同步主机名映射；LANG 避免终端乱码。
- 修改
/etc/wsl.conf后必须退出所有 WSL 实例并运行wsl --shutdown，否则不生效 - 时区同步靠
sudo timedatectl set-timezone $(cat /etc/timezone)，但更稳的方式是在 Windows 中设好时区，再加[wsl2]段落到%USERPROFILE%\AppData\Local\Packages\...\wsl.conf（全局 WSL2 配置） - 如果仍 DNS 失败，检查 Windows 主机是否启用了 IPv6，WSL2 当前对 IPv6 DNS 支持不稳定，可临时在
/etc/resolv.conf中硬编码nameserver 8.8.8.8（但该文件会被自动覆盖，得配合generateResolvConf = false）
从 WSL1 升级到 WSL2 后磁盘 I/O 明显变慢
不是硬件问题，是 WSL2 默认使用 ext4 over VHDX，而 VHDX 在 Windows NTFS 上存在双重日志开销。尤其小文件读写、git status、npm install 这类操作延迟明显。
优化路径只有两条：一是把项目目录移到 WSL2 内部文件系统（如 /home/xxx/project），避开跨文件系统访问；二是启用实验性配置 metadata=true，在 /etc/wsl.conf 的 [wsl2] 段下加：
filesystem = "ext4"<br>metadata = true。这会让 WSL2 绕过部分 NTFS 元数据限制，提升 30%~50% 小文件性能。
-
metadata=true仅在 Windows 11 22H2+ 或 Windows 10 21H2+ 生效，旧版本忽略该配置 - 不要在 Windows 文件系统（如
/mnt/c/xxx）里运行 Docker 构建或数据库，I/O 延迟可能高 5 倍以上 - VHDX 文件会持续增长但不自动收缩，用
wsl --shutdown后在 PowerShell 运行diskpart → select vdisk file="...\ext4.vhdx" → attach vdisk → compact vdisk才能回收空间
