以下是 Windows 11 系统中 **WSL2 完整安装流程**及**迁移到 D 盘**的详细步骤，结合官方文档与社区实践整理，涵盖常见问题解决方案：

### 一、安装前准备

#### 1\. **启用 WSL2 功能**

- **方式一（推荐）**：管理员身份运行 PowerShell，输入：

  ```powershell
  wsl --install -d Ubuntu-22.04  # 自动启用所需功能并安装 Ubuntu
  ```

  **解释**：此命令自动启用 WSL 和虚拟机平台，无需手动配置

- **方式二（手动启用）**：

  ```powershell
  dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  wsl --set-default-version 2  # 设置默认版本为 WSL2
  ```

  **注意**：完成后需重启系统  
  **启用虚拟化与系统功能**  
  BIOS 设置：  
  进入 BIOS → 启用 Intel VT-x/AMD-V（具体名称因主板而异）  
  Windows 功能：  
  打开“控制面板 → 程序 → 启用或关闭 Windows 功能”。  
  勾选 Hyper-V、虚拟机平台、适用于 Linux 的 Windows 子系统  
  重启系统。

#### 2\. **更新 WSL 内核**

- 下载并安装 [WSL2 内核更新包](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi)，防止兼容性问题

---

### 二、安装 Linux 发行版到 D 盘

#### 1\. **初始安装（C 盘）**

- 从 Microsoft Store 安装 **Ubuntu 22.04**，首次启动设置用户名和密码

#### 2\. **导出发行版**

- 关闭 Ubuntu 后，管理员 PowerShell 执行：

  ```powershell
  wsl --export Ubuntu-22.04 D:\WSL\Ubuntu-22.04.tar  # 导出为 TAR 文件
  ```

#### 3\. **注销原系统**

```powershell
wsl --unregister Ubuntu-22.04  # 删除 C 盘中的旧系统
```

#### 4\. **导入到 D 盘**

```powershell
wsl --import Ubuntu-22.04 D:\WSL\Ubuntu-22.04 D:\WSL\Ubuntu-22.04.tar --version 2
```

**参数说明**：

- `D:\WSL\Ubuntu-22.04`：目标目录
- `--version 2`：强制使用 WSL2

#### 5\. **恢复默认用户**

- 若导入后默认以 root 登录，执行：

  ```powershell
  Ubuntu2204.exe config --default-user <原用户名>
  ```

---

### 三、常见问题解决

#### 1\. **安装失败错误码**

- **0x80070003**：检查系统存储位置是否在 C 盘（设置 → 存储 → 默认保存位置）

- **0x8007019e**：确认已启用“虚拟机平台”功能

- **WSL 启动卡死**：重置网络配置或更新 WSL：

  ```powershell
  wsl --update  # 更新内核
  netsh winsock reset  # 重置网络
  ```

#### 2\. **迁移后权限问题**

- 若导入后文件权限异常，需手动调整 `/etc/wsl.conf`：

  ```ini
  [automount]
  options = "metadata,umask=022"
  ```

#### 3\. **虚拟化未启用**

- BIOS 中开启 **Intel VT-x/AMD-V**，并在 PowerShell 中执行：

  ```powershell
  bcdedit /set hypervisorlaunchtype auto  # 启用 Hyper-V 虚拟化。
  ```

---

### 四、高级配置

#### 1\. **性能优化**

- 创建 `%USERPROFILE%\.wslconfig` 文件，限制资源使用：

  ```ini
  [wsl2]
  memory=4GB   # 限制内存
  processors=2  # 限制 CPU 核心
  ```

#### 2\. **换用国内镜像源**

- 在 Ubuntu 中执行：

  ```bash
  sudo sed -i 's/archive.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list
  sudo apt update && sudo apt upgrade -y
  ```

#### 3\. **GUI 应用支持**

- 安装 X 服务器（如 VcXsrv），在 Ubuntu 中设置：

  ```bash
  echo "export DISPLAY=$(awk '/nameserver / {print $2}' /etc/resolv.conf):0" >> ~/.bashrc
  ```