559 words

3 minutes

WSL2 完整参考手册

2026-02-05

成长日记/Linux

WSL

Windows

Linux

WSL2 完整参考手册 (全流程版)#

1. 安装与初始化#

系统要求：Windows 10 (Build 19041+) 或 Windows 11

检查虚拟化#

打开任务管理器 -> 性能 -> CPU。
确认右下角显示 虚拟化：已启用。
若未启用，需进入 BIOS 开启 Intel VT-x 或 AMD-V。

执行安装#

一键安装默认版本 (Ubuntu)：

1
wsl --install

安装后必须重启计算机。

安装指定版本：

1
# 查看可用列表
2
wsl --list --online
3
# 安装指定发行版 (如 Debian)
4
wsl --install -d Debian

初始化配置#

重启后终端自动弹出，按提示设置：

Enter new UNIX username: 输入用户名 (建议纯小写英文)。
New password: 输入密码 (注意：输入时屏幕不显示任何字符，直接回车)。

2. 核心生命周期控制 (启停与状态)#

启动与进入#

1
# 启动默认系统
2
wsl
3

4
# 启动指定系统
5
wsl -d Ubuntu-22.04
6

7
# 以 Root 用户身份登录
8
wsl -u root

退出与关闭#

1
# 退出当前终端
2
exit  # 或 Ctrl + D
3

4
# 关闭指定系统 (释放内存)
5
wsl --terminate Ubuntu-22.04
6

7
# 彻底关闭所有 WSL 实例
8
wsl --shutdown

查看状态#

1
wsl -l -v

3. 系统迁移 (更改安装路径)#

默认在 C 盘，建议安装后立即迁移至 D 盘。

方案 A：在线热迁移 (推荐)#

1
# 1. 确保目标目录存在
2
mkdir D:\WSL\Ubuntu
3

4
# 2. 彻底关闭 WSL
5
wsl --shutdown
6

7
# 3. 执行迁移
8
wsl --manage Ubuntu-22.04 --move D:\WSL\Ubuntu

方案 B：导入导出法#

1
# 1. 导出备份
2
wsl --export Ubuntu-22.04 D:\backup.tar
3

4
# 2. 注销原系统
5
wsl --unregister Ubuntu-22.04
6

7
# 3. 导入到新位置
8
wsl --import Ubuntu-22.04 D:\WSL\Ubuntu D:\backup.tar --version 2

4. 环境与性能优化#

更换国内源#

1
# 1. 备份源文件
2
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
3

4
# 2. 替换为阿里云镜像
5
sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
6
sudo sed -i 's/security.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
7

8
# 3. 更新缓存
9
sudo apt update

内存与 CPU 限制#

在 Windows 用户目录创建 .wslconfig 文件：

1
[wsl2]
2
memory=4GB
3
processors=2
4
swap=4GB

修改后需执行 wsl --shutdown 生效。

5. 交互与文件管理#

文件互通#

在 Windows 访问 Linux 文件：explorer.exe .
在 Linux 访问 Windows 文件：cd /mnt/c/Users/你的用户名/Desktop

VS Code 集成#

Windows 端安装 VS Code
VS Code 安装插件 “WSL”
在 Linux 终端项目目录下输入：code .

6. 磁盘维护 (空间回收)#

1
wsl --shutdown
2
diskpart
3
select vdisk file="D:\WSL\Ubuntu\ext4.vhdx"
4
attach vdisk readonly
5
compact vdisk
6
detach vdisk
7
exit

WSL2 完整参考手册

/blog/posts/成长日记/linux/wsl/

Author

Zenfish

Published at