WSL 快速开始

安装 WSL

安装步骤

1. 在 BIOS 设置界面中，开启 cpu 虚拟化（Intel VT-x 或 AMD-V）

   tip：重启电脑，进入 BIOS 设置界面（通常按 F2、F10、Del 键）

2. 在 “启用或者关闭 Windows 功能” 中开启：

   • 适用于 Linux 的 Windows 子系统
   • Virtual Machine Platform | 虚拟机平台

3. 等待重启

4. 手动更新 wsl 内核：

   wsl --update

5. 安装 distro 发行版（可参考 wsl 命令）

常见问题

wsl --update 提示 403 错误

关闭代理。

wsl --update 下载慢

1. 访问 WSL 发布页
2. 下载指定版本的 .msi 文件
3. 运行 .msi 文件

管理 distro 发行版

查看

# 查看可用发行版
wsl --list --online

# 查看已安装的发行版
wsl --list --verbose

安装/卸载/设置默认

# 安装
wsl --install -d <发行版名称>
# 卸载
wsl --unregister <发行版名称>

# 设置默认发行版
wsl --set-default <发行版名称>

安装好后，首次需要设置用户名、密码。

启动/停止

# 运行默认
wsl
# 指定发行版
wsl -d Ubuntu

# 停止所有
wsl --shutdown

备份 & 恢复

# 备份
wsl --export <发行版名称> <导出路径>
# 示例
wsl --export Ubuntu ubuntu.tar

# 恢复
wsl --import <自定义名称> <安装目录> <导出路径>
# 示例
wsl --import Ubuntu D:/wsl ubuntu.tar

常见问题

与主机的通信规则

文件共享

默认情况下，windows 下的文件系统会挂载到子系统中。

当心

尽量不要使用挂载卷的方式，IO 压力很大，性能很差！若有数据需要使用，建议直接拷贝至子系统，直接在子系统中使用。

命令混用

• 子系统中可以运行 windows 程序。
• windows 可以直接使用子系统的命令。