舒孝元博客

# Windows上使用wsl

## 前期准备

- 安装 `terminal` 终端
用这个比 `cmd` 要舒服，安装地址 : https://learn.microsoft.com/zh-cn/windows/terminal/install

- 开启 Windows 子系统功能

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751374090_9uSrVvHtMW.png)

如果需要重启电脑，请重启，默认都是较新的系统，如果需要手动安装旧版本，可能需要开启虚拟化功能和安装`适用于 x64 计算机的 WSL2 Linux 内核更新包`，包下载地址：https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

## 安装 WSL

将 WSL 2 设置为默认版本 `wsl --set-default-version 2`

如果一切都默认安装，则管理员打开终端，执行 `wsl --install` 会安装 `wsl` 和安装 `Linux` 的 `Ubuntu` 子系统的默认发行版本，后期也可以安装指定的其他版本

`wsl 1` 和 `wsl 2` 的区别，更详细的请 [点击查看官方介绍](https://learn.microsoft.com/zh-cn/windows/wsl/compare-versions "点击查看官方介绍")

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751374273_YfmzSKNsOr.png)

默认安装的是 `wsl 2`，如果不是，建议转换成 `wsl 2`，转换命令 `wsl --set-version <distro name> 2`

例如 `wsl --set-version Ubuntu-20.04 2`将 Ubuntu 20.04 分发版设置为使用 WSL 2

查看 `wsl` 版本命令 `wsl -l -v`

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751374547_reS3bT8tBA.png)

## 初始化 WSL

可以去下载安装包: [GitHub地址](https://github.com/microsoft/WSL/releases "GitHub地址")

安装完成后，在开始菜单中查找 `WSL` 和 `WSL Settings`，如下图所示，`WSL Settings`可以设置相应参数，一般默认即可

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751374777_pHIZaXl9fJ.png)

点击 `WSL` 会打开安装的 `Ubuntu` 子系统，第一次打开需要进行相应的设置，账号密码之类的，按照提示进行即可

## 安装其他版本

打开应用商店，搜索你喜欢的版本安装即可

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751375071_klyGrRxqWx.png)

如果应用商店没有你想要的系统或版本，比如 `CentOS`，那就需要手动安装，这里不做说明，有需要的请给我发送邮箱说明，看到后会回复你

## 使用 WSL

选择你相应的 Linux 版本进入即可，这里就是 Linux 子系统环境，Linux的命令和功能这里都能用

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751375613_1CPeXqdbQw.png)

## 配合 Docker Desktop

Windows 上安装 `Docker Desktop` 略，不做介绍，请自行安装

打开设置，选择你需要链接的 `Linux` 版本，然后可以进入该子系统中直接执行 `Docker` 命令，子系统中不需要安装 `docker`

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751375834_d8RXmAxOOb.png)

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751375965_qV9LNGSkDL.png)

## 配合 IDE

安装好子系统后，在 `Windows` 的资源管理器中，会有相应的挂载盘，可以方便你和 `Windows` 系统直接复制粘贴文件

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751376213_lJZn40FriN.png)

在 IDE 中，直接打开你存放在 `Ubuntu` 中的项目文件即可，你的环境啥的，应该都安装在子系统中，比如`git`、`php`、`npm`等等，这就不用我多说了吧，因为你打开子系统中的项目后，在IDE中打开`终端`窗口，也是打开的子系统中的

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751376389_Hfdr8jBjkh.png)

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751376874_69sZHM89sm.png)

切记不要使用这个远程开发

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751376550_iv6aojZWhS.png)

如果你只想代码跑在子系统中，所有的环境还是在 Windows 主机下，可以使用 `工具->部署`，记得勾选保存文件后自动上传，还有本地删除后，远端也同步删除，保证本地和远端代码完全一致，不过这个其实不太方便，因为你的日志啥的信息，还是存在子系统中

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751377012_fC4On8CRl0.png)

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/website/admin/20250701/1751377235_Esk8O30WKW.png)

WSL使用说明