准备工作

检查 Windows 版本/Build：

• 打开 Win 键 → 输入 winver → 回车。
• 若要使用 WSL2，需要 Windows 10 版本 1903（Build 18362.1049）或更高（更可靠的是 2004 及以上）。如果 Windows 版本太旧，请先用 Windows Update升级

确认 CPU 虚拟化已启用（BIOS/UEFI）

• 进入 BIOS/UEFI，确认 Intel VT-x 或 AMD SVM（有时叫 Virtualization Technology）已启用。
• 如果在虚拟机内运行 Windows（例如 VMware/VirtualBox），需要启用嵌套虚拟化，或在主机上直接安装 WSL。

决定使用 WSL1 还是 WSL2

• 推荐 WSL2（完整 Linux 内核，性能和兼容性更好，Docker 等工具兼容）。但 WSL2 需要 VM 平台支持（Windows 特性）。如果你需要在非常旧的 Windows 或某些受限环境下运行，可选择 WSL1。

一键安装

以管理员权限打开 PowerShell：

在开始菜单输入 PowerShell → 右键 “Run as administrator”。

运行（一行命令）：

wsl --install -d Debian

这个命令会启用必要的 Windows 特性、安装或更新 WSL 内核（若需要）、并从 Microsoft Store 安装 Debian 发行版。安装完成后系统会提示重启（如果需要）。

首次启动 Debian：

在开始菜单找到 “Debian” 应用并运行，或者在 PowerShell 执行 wsl -d Debian。首次启动会完成用户创建（设置用户名和密码）与初始化。

验证和设置默认 WSL 版本（可选）：

wsl --list --verbose
wsl --set-default-version 2
wsl --set-default Debian    # 若希望以 Debian 作为默认发行版

wsl --list --verbose 会显示你安装的发行版及使用的 WSL 版本（1 或 2）。

在windows文件浏览器中输入 //wsl$ 可以直达虚拟系统的根目录。

手动安装

当 wsl --install 不可用或你需要分步控制

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

若要使用 WSL2（推荐），启用 Virtual Machine Platform：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

完成后建议重启电脑

安装或更新 WSL2 Linux 内核（如果提示需要）：

从微软官方提供的内核更新包下载安装（https://aka.ms/wsl2kernel），然后运行安装包。或使用 wsl --update（若可用）。Microsoft Learn+1

在 Microsoft Store 安装 Debian：

打开 Microsoft Store → 搜索 “Debian” → Install。安装完成后在开始菜单打开 Debian（首次运行时会要求创建 Linux 用户）。（若禁用 Store，可从微软官方手动下载 .appx 包并用 Add-AppxPackage 安装）。

将已安装发行版设置为 WSL2（如果默认不是）：

wsl --set-version Debian 2

这会把 Debian 切换到 WSL2（首次转换可能需要一些时间）

常见注意事项与建议

Windows 版本兼容性：如果 wsl --install 报错或 Windows 版本过旧，请先检查 winver 并升级到支持的 Windows 10 构建。详见 Microsoft 文档。

BIOS/UEFI 虚拟化：若无法启用 Virtual Machine Platform，通常是 BIOS 虚拟化没开。进入 BIOS 打开 VT-x / SVM。

Hyper-V / 其他虚拟化软件冲突：

在 Windows 10 Pro 上启用 Hyper-V / Virtual Machine Platform 可能影响旧版 VirtualBox、VMware 的某些功能（需用新版兼容版本或启用 Hyper-V 支持）。如果你依赖其他虚拟化软件，请确认兼容性或考虑仅启用必要功能。

公司/受限环境：某些企业策略会禁用 Microsoft Store 或禁用安装 Windows 功能。如果无法使用 Store，可下载官方发行版的 Appx 包并使用管理员 Add-AppxPackage 安装，或使用 wsl --import 从 tar 文件导入自定义 rootfs。

WSL 与文件位置：

WSL 的 Linux 文件系统位于 %LOCALAPPDATA%\Packages\... 下（不建议直接在 Windows 文件管理器中编辑 WSL 内部 Linux 文件）。建议在 Windows 与 WSL 之间交换文件使用 \\wsl$\ 网络路径或在 WSL 中访问 Windows 驱动器（例如 /mnt/c）。直接修改 WSL 内部文件可能导致数据损坏。

系统服务 / systemd：

传统 Linux 服务管理（systemd）在较老的 WSL 环境中不一定可用（近年来有改进，但在 Windows 10 上的支持可能受限）；如果需要 systemd 支持，请参考官方文档并确认你的 Windows/WSL 版本是否支持。避免假设全部 systemd 服务会像在真实 Linux 上那样工作。

备份与卸载：

导出备份：wsl --export Debian debian-backup.tar

注销/卸载：先在 PowerShell 里 wsl --unregister Debian（这会删除该发行版的所有数据，谨慎使用）。

#debian #Linux #Windows10 #子系统