注意：本文方法须在 win10 或 win11 环境下运行，其他环境可能无配置。

一、安装 Linux 子系统

Step 1.

依次输入如下命令

1
2
wsl --update
wsl --set-default-version 2

对于第一个命令，如果速度较慢，可以更换为

1
wsl --update --web-download

随后重新启动电脑。

Step 2.

输入如下命令

1
wsl -l -o

可以看到如下反馈即为正常

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
以下是可安装的有效分发的列表。
使用 'wsl.exe --install <Distro>' 安装。

NAME                            FRIENDLY NAME
Ubuntu                          Ubuntu
Debian                          Debian GNU/Linux
kali-linux                      Kali Linux Rolling
Ubuntu-18.04                    Ubuntu 18.04 LTS
Ubuntu-20.04                    Ubuntu 20.04 LTS
Ubuntu-22.04                    Ubuntu 22.04 LTS
Ubuntu-24.04                    Ubuntu 24.04 LTS
OracleLinux_7_9                 Oracle Linux 7.9
OracleLinux_8_7                 Oracle Linux 8.7
OracleLinux_9_1                 Oracle Linux 9.1
openSUSE-Leap-15.6              openSUSE Leap 15.6
SUSE-Linux-Enterprise-15-SP5    SUSE Linux Enterprise 15 SP5
SUSE-Linux-Enterprise-15-SP6    SUSE Linux Enterprise 15 SP6
openSUSE-Tumbleweed             openSUSE Tumbleweed

如果出现反馈

1
2
无法从“https://raw.githubusercontent.com/microsoft/WSL/master/distributions/DistributionInfo.json”中提取列表分发。无法与服务器建立连接
Error code: Wsl/WININET_E_CANNOT_CONNECT

或错误代码，则网络联通不畅，需要加速器连接或准备梯子。

这一步也许不是必要的，笔者已经提供了足够的安装信息以供下文使用。

Step 3.

在上面的反馈中可以看到名称和发行版名称，在终端中运行如下命令安装发行版

1
wsl.exe --install <NAME>

如果网路连接不畅，可以运行

1
wsl.exe --install <NAME> --web-download

安装完成后按照提示设置用户名和密码即可。

子系统安装成功。

二、使用 VS Code 在 子系统中工作

Step 1.

在 Windows 下找到子系统应用，其名字就是上面信息中的 <NAME>。如果使用 Windows11，可以在终端中任务栏的加号处找到。

之后进入 Bash。

1
2
3
cd /home
sudo mkdir workspace
cd workspace

创建工作文件夹。

接下来为当前文件夹设置根权限。这一步很重要，如果不进行会导致在 VS Code 中无法编辑文件。

1
sudo chown -R <usrname> /home/workspace/

Step 2.

在 Windows 下启动 Visual Studio Code，添加扩展 WSL。

返回 Bash 终端中，运行

1
code .

即可在当前位置打开终端。

第一次需要在 VS Code 中配置相关扩展，初次编写代码后在右下角跟随提示选择安装编译器即可。

之后可以在 Windows 下 VS Code 软件中 左侧 “远程资源管理器” 栏目内快速进入 WSL。