WSL（Windows 中使用 Linux）笔记

贡献者： addis

本文处于草稿阶段。

　　重要提示：截至到 2023 年 8 月，WSL 在中国大陆的安装过程中可能会遇到某种网络问题。

　　重要提示：WSL1 用于 NTFS 文件系统最合适，包括移动硬盘。exFAT 兼容性较差（不兼容软链，git 也会有权限 bug）。NTFS 用 WSL1 也不完美，有时候 chmod -R 不能真正的深入到每个子目录，还可能要 cd 进去再次用 chmod -R，或者直接 find . -type f -exec sudo chmod 777 {} \;（巨慢）。且这么做只能临时有效，打开另一个命令行就没用了。GDB 也不能用（设置断点失败）。

　　所以，有条件用双系统或者 Virtualbox 还是建议尽量用它们。

1. cmd 中的 wsl 命令

官方文档
wsl --help 获取帮助（以下说明可能会和最新版本稍微不一致，所以建议直接看帮助）
wsl --shutdown 关闭所有 distro 和虚拟机
wsl --status 显示 wsl 状态
wsl --update 更新
wsl --set-default-version 1或2 切换新安装 wsl 的默认的版本
wsl --set-version Ubuntu-22.04 1或2 把某个已安装的 distro 在 WSL1 和 2 之间转换，如果 Turn Windows Features On or OFF 中没有开 Virtual Machine Platform，会提示错误且不做转换，打开这个和 Hyper-V，重启即可。转换需要两三分钟。注意这并不会把整个 linux 的文件系统都变成 ext4 的虚拟硬盘（可以用 WinDirStat 验证）。其实还是另外新装 wsl2 版本的 ubuntu 比较好，因为 WSL1 没有 snap store 和正常的 systemd systemctl 等。可以用下面的方法把某个 WSL1 distro 重命名，再安装相同的 WSL2 distro（没试过）。
wsl --set-default [distro] 选择默认的 distro
wsl --list 列出所有 distro wsl --list --verbose（-l -v）显示详细信息
wsl --list --online 列出所有可下载的 distro
wsl --install -d 安装某个 distro
WSL 虚拟机的默认路径是 C:/Users/用户名/AppData/Local/Packages/CanonicalGroup...distro版本号/
wsl --unregister ... 删除某个 distro 以及它的所有文件
镜像导出导入
wsl --export distro名导出文件名 可以导出 wsl。例如 wsl --export Ubuntu ubuntu.tar 导出文件会存到当前路径。
export 和 import 可以把同一个 distro 安装多份或者重命名。
wsl --import 新distro名安装路径导出文件名 --version 1或2 例如 wsl --import Ubuntu-20.04-WSL1-20220904 C:\Users\用户名\ C:\Users\用户名\Desktop\Ubuntu-20.04-WSL1-20220904.tar --version 1或2 注意 import 以后默认会以 root 身份登录，可以设置 .bashrc 自动 su 成某个用户。
No3/WSL-images/Ubuntu-20.04-WSL2-20220905.tar 是从 Miranda 的 Win11 备份的镜像，亲测在 Surface 上可以直接 import，X11 可用（但是 CLion 好卡）
import wsl 以后，会默认用 root 登录，先试试 xeyes 可不可以（apt install x11-apps）。可以的话 cp ~/.Xautority /home/用户名/ 然后 su 用户名 再试试 xeyes 可不可以。可以的话就把这两个命令添加到 /root/.bashrc 中。

2. WSL1 还是 WSL2

WSL1 是 Windows 套壳，system call 都是通过调用 Windows 的 system call 来实现的。
WSL2 是虚拟机，兼容性是最好的，Windows 上的 docker 的新版本就是基于 WSL2。
WSL 的网络是直接使用 Windows 的，而 WSL2 的网络是基于虚拟机的虚拟网卡。
WSL 即使使用 NTFS 也可以支持 symlink。
（待重新测试新版本）目前来说 WSL 在 NTFS 文件系统中的读写速度比 WSL 2 快很多
WSL2 无论在 Win 10 还是 11 都支持 GUI。可以用 xeyes 测试，而 WSL1 不行。
WSL1 和 2 是可以互相转换的，所以选错了也没关系。

3. ssh 到 WSL

WSL1 中 ssh 似乎需要自己重新安装一下才行。每次开机都需要 sudo service ssh --full-restart 才会运行。
很容易可以从其他机器通过 ip 地址和端口 22 ssh 到 WSL1
WSL1 是 windows 开机就运行的，而不是打开 terminal 才开始运行。所以只要 windows 开着就可以 ssh 连接
WSL 的 IP 地址 (用 ifconfig 查看) 和 windows 的 IP 地址 (在 cmd 中用 ipconfig) 是一样的，而不是像虚拟机一样使用 NAT
所以设置 sshd 的方法基本上和任何 linux 主机一样，安装 openssh-server 即可
重启 windows 以后貌似 service 会停止，要自动还需要一些设置
不行的话就重装一下 openssh-server
如果说 sshd: no hostkeys available -- exiting.，那就用 sudo ssh-keygen -A

4. WSL 内挂载 windows 硬盘

例如 sudo mount -o uid=用户名 -t drvfs g: /mnt/g

5. 中文乱吗

确保系统语言设置里面的 Nonunicode 程序显示为 Chinese (Simplified)，否则全部中文都是乱码

6. 使用 MobaXterm 显示 WSL 的图形界面

mobaxter 可以直接 `ssh localhost` 进入 wsl，可以使用 X11 的图形界面
参考这里
确保 MobaXterm 是打开的，且右上角的 X 标志正在运行
在 .bashrc 文件中添加 export DISPLAY=:0，重启终端即可
测试了 firefox，nautilus 都没问题

7. 启动时运行程序

　　使用以下方法，可以在第一次手动打开 WSL 或者在 windows 登录后自动运行一些 WSL 程序。

创建 /etc/wsl.conf，内容如下即可。
```
[boot]
command="命令1; 命令2"
```
其中的命令会直接使用 sudo 权限运行。这些命令会在 WSL 启动时执行（注意不是每次打开 WSL 命令行，而是第一次打开时执行）。输出不会显示在命令行中。也会在 cmd 中输入 wsl --shutdown 然后再打开 WSL 命令行时运行。
若想开机自动运行，可以把 wsl.exe（任务管理器里面可以找到进程的可执行文件的位置）创建一个快捷方式到启动文件夹 C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp。
command 中不可以使用 & 后台执行，相当于有一个看不见的命令行窗口在执行这些。
例如可以用这个自动挂载硬盘：mount -o uid=addis -t drvfs g: /mnt/g;
可以执行 service 命令。例如用于开启 sshd：service ssh --full-restart;
cmd 中 wsl -l -v 必须要显示 running，WSL 才有可能执行任何东西包括 service。
可以在最后执行一个永不结束的命令（就不用配置 service 这么麻烦），如 frp
WSL1 不支持 systemd，只有 WSL2 支持。
笔者的设置为：command="date >> /home/addis/WSL-start-log.txt; service ssh --full-restart; mount -o uid=xxx -t drvfs e: /mnt/e; /home/用户名/frp/frpc -c /home/addis/frp/frpc.ini > /home/用户名/frp/frpc.log;"。其中 frpc 见这里。

8. Bug 和兼容问题

WSL1 不支持 systemd，WSL2 目前支持。
WSL1 + NTFS 在同一个文件夹中不支持用大小写区分不同的文件和文件夹
【可绕过】WSL1 在外挂 exFAT 硬盘中用 git 还是会有权限错误。但实际上整个 .git 的任何文件都可以读写（可以把 .git 文件夹复制一份都没问题）。经测试，重新格式化为 NTFS 文件系统即可。
exFAT 无论在哪里都不支持 symlink，但 NTFS 对 WSL 和 Ubuntu 都支持 symlink！
用 Ubuntu 操作过的 NTFS 磁盘在 WSL1 中可能会出现权限问题，但用 sudo chmod -R 755 . 就没问题了。
在 U 盘中实测 NTFS 的小文件写入速度比 exFAT 还要快 30% 左右。

致读者：小时百科一直以来坚持所有内容免费无广告，这导致我们处于严重的亏损状态。长此以往很可能会最终导致我们不得不选择大量广告以及内容付费等。因此，我们请求广大读者热心打赏 ，使网站得以健康发展。如果看到这条信息的每位读者能慷慨打赏 20 元，我们一周就能脱离亏损，并在接下来的一年里向所有读者继续免费提供优质内容。但遗憾的是只有不到 1% 的读者愿意捐款，他们的付出帮助了 99% 的读者免费获取知识，我们在此表示感谢。