
## 🧩 一、安装与初始化

| 命令                                  | 说明                                                              |
| ----------------------------------- | --------------------------------------------------------------- |
| `wsl --install`                     | **一键安装 WSL2**（默认 Ubuntu），自动启用功能、下载内核并设为默认版本 [[1]]               |
| `wsl --install -d <发行版名>`           | 安装指定发行版（如 `Debian`, `Ubuntu-24.04`, `openSUSE-Tumbleweed`）[[4]] |
| `wsl --list --online` 或 `wsl -l -o` | 列出 Microsoft Store 中**可安装的 Linux 发行版** [[3]]                    |
wsl --list --online
---
## 📋 二、查看与管理发行版

| 命令                                         | 说明                                                         |
| ------------------------------------------ | ---------------------------------------------------------- |
| `wsl -l -v` 或 `wsl --list --verbose`       | **列出所有已安装的发行版**、状态（Running/Stopped）和 WSL 版本（1/2）[[3]][[5]] |
| `wsl`                                      | 启动**默认发行版**                                                |
| `wsl -d <发行版名>`                            | 启动指定发行版（如 `wsl -d Debian`）                                 |
| `wsl --set-default <发行版名>`                 | 设置默认启动的发行版                                                 |
| `wsl --terminate <发行版名>` 或 `wsl -t <发行版名>` | **强制终止**指定发行版（释放资源）                                        |
| `wsl --shutdown`                           | **关闭所有 WSL 实例**（常用于重载 `.wslconfig` 或释放端口）[[9]]             |

---

## ⚙️ 三、版本与内核管理

| 命令 | 说明 |
|------|------|
| `wsl --set-default-version 2` | **设置新安装的发行版默认使用 WSL2** [[4]] |
| `wsl --set-version <发行版名> 2` | 将指定发行版**从 WSL1 升级到 WSL2**（反之亦然）[[5]] |
| `wsl --update` | **手动更新 WSL 内核**到最新版本（需联网） |
| `wsl --version` | 查看 WSL 客户端和内核版本（确认是否支持 `systemd` 等新特性） |

---

## 🌐 四、文件系统与互操作

| 命令 | 说明 |
|------|------|
| `explorer.exe .` | 在当前 Linux 目录打开 **Windows 文件资源管理器** |
| `/mnt/c/` | 访问 Windows C 盘（其他盘符同理） |
| `code .` | 在当前目录启动 **VS Code**（需先在 Windows 安装 VS Code 并勾选“WSL 集成”） |
| `wsl --mount <磁盘>` | 挂载物理磁盘（高级用法，需管理员权限） |

---

## 🛠️ 五、高级配置（`.wslconfig`）

在 Windows 用户目录 `%USERPROFILE%`（即 `C:\Users\<用户名>`）下创建文件 `.wslconfig`，例如：

```ini
[wsl2]
memory=4GB
processors=2
swap=2GB
localhostForwarding=true
systemd=true        # 启用 systemd（WSL 2.0+ 原生支持）
```

修改后执行 `wsl --shutdown` 重启生效 [[9]]。

---

## 🔍 六、故障排查

| 场景 | 建议命令 |
|------|--------|
| 安装后不显示发行版 | 通过 **开始菜单启动一次**，或检查虚拟化是否启用 |
| 端口占用 / 网络异常 | `wsl --shutdown` 重启 WSL |
| 性能卡顿 | 检查 `.wslconfig` 资源限制，或关闭不必要的后台发行版 |
| 无法访问 localhost | 确保 `localhostForwarding=true`（默认开启） |
