适用于 Linux 的 Windows 子系统文档：微软官方文档

Docker Desktop WSL 2 backend：Docker 官方文档

Using Docker in WSL 2：VSCode官方文档
WSL 使用中遇到的问题及解决方案 #4 - Git 仓库中所有文件被标记为 modified

Win10+WSL开发踩坑记录

git windows和mac换行符冲突问题

1.. wsl install

Rename Ubuntu.1604.2017.711.0_v1.appx to Ubuntu.1604.2017.711.0_v1.zip and extract all in to a folder.

Run Ubuntu.exe inside the extracted folder as Administrator.


2.. wsl uninstall

you can see the list of installed distros:

wslconfig /l

delete distro for the list

wslconfig /u ubuntu


3... wsl proxy

Ubuntu:

/etc/apt/apt.conf

Acquire::http::Proxy "http://proxy01.bizerba.com:8080";

Acquire::https::Proxy "https://proxy01.bizerba.com:8080";

Debian:

/etc/apt/apt.conf

Acquire::http::Proxy "http://proxy01.bizerba.com:8080";

Acquire::https::Proxy "https://proxy01.bizerba.com:8080";

4.. wsl mount USB disk

if your usb disk in windows is partition E:\

mkdir -p /mnt/e

mount -t drvfs e: /mnt/e

 

升级WSL到WSL2
WSL2
依赖
操作流程
可能遇到的问题

WSL2
windows 10  build 18917开始使用WSL2，WSL2与WSL1相比，支持的feature更多：


依赖
如果要升级到WSL2，需要满足一下几个条件：

Windows 10 build 18917 或更高版本；
启用“虚拟机平台”可选组件；
在bios上启用虚拟化；

操作流程
首先打开PowerShell
wsl --list --verbos

会看到如下：



可以看到已安装的wsl版本情况。如果想升级wsl为wsl2，需要输入如下命令：
 wsl --set-default-version 2

会看到如下提示：



代表设置成功了。如果这一步操作失败，请参考升级需要的前提条件。

设置之后，在微软应用商店里可以选择按照linux的发现版本，此时就是WSL2内核的了。

如果想升级旧版本的wsl，在上一步中输入之前按照的linux版本号。即：
 wsl --set-default-version Ubuntu-20.04 2

可能遇到的问题
设置了wsl2后，如果在安装linux过程中出现：

WslRegisterDistribution failed with error: 0xc03a001a

解决方案：
找到 C:\Users\你的用户名\AppData\Local\Packages
找到 CanonicalGroupLimited.Ubuntu20.04onWindows 前缀的文件夹
在这个文件夹上右键>属性>高级
取消勾选压缩内容以节省磁盘空间
确定

关于使用WSL2出现“参考的对象类型不支持尝试的操作”的解决方法。


解决方法：

常见临时解决方案（不推荐）：

以管理员身份运行CMD，输入：
netsh winsock reset

重启计算机即可修复。

长期解决的方案（推荐）：

（1）下载此软件：

www.proxifier.com/tmp/Test20200228/NoLsp.exe​
（2）管理员身份运行CMD输入：
NoLsp.exe C:\windows\system32\wsl.exe

请自行注意NoLsp.exe程序的位置，以及你的wsl.exe位置。
产生原因和解决方法分析：
代理软件和wsl2的sock端口冲突，使用netsh winsock reset重置修复。Proxifer开发人员解释如下：

如果Winsock LSP DLL被加载到其进程中，则wsl.exe将显示此错误。最简单的解决方案是对wsl.exe使用WSCSetApplicationCategory WinAPI调用来防止这种情况。在后台，该调用在HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WinSock2\Parameters\AppId_Catalog中为wsl.exe创建一个条目。
这将告诉Windows不要将LSP DLL加载到wsl.exe进程中

文章目录
微软 Win10 版本 2004 系统
升级WSL到WSL2
第一步：打开系统虚拟机平台
第二步：安装WSL2
第三步：将wsl2设置为默认
WSL 2 中的新增功能
将分发版版本设置为 WSL 1 或 WSL 2
比较 WSL 2 和 WSL 1
管理子系统
查看子系统列表
设置默认启动的子系统
注销并重新安装发行版

微软 Win10 版本 2004 系统

首先到设置里升级系统版本到2004



如何查看当前系统版本

通过按 Windows 徽标键 + R， 检查你的 Windows 版本，然后键入winver，选择“确定” 。 （或者在 Windows 命令提示符下输入 ver 命令）。 如果内部版本低于 19041，请更新到最新的 Windows 版本。 获取 Windows 更新助手。




2020 Windows 10 更新五月版（2004版）系统要求：
内存：用于计算机64位的2GB 内存和用于32位的1GB 内存。
存储：64位系统需要20GB的可用空间，而32位系统需要16GB的可用空间。
屏幕分辨率：800×600
图形：Microsoft DirectX 9或更高版本以及WDDM 1.0
英特尔CPU：所有处理器最高支持第10代，英特尔至强E-22xx，凌动，赛扬和奔腾。
AMD CPU：所有处理器最高支持第七代。
高通CPU：骁龙850和8cx。




可以手动下载最新ISO更新，不推荐
如果使用的是 ARM64 计算机，请下载 ARM64 包。
微软 Win10 版本 2004 正式版官方 ISO 镜像下载大全


升级WSL到WSL2
首先需要确保已经安装了WSL，才能从WSL升级到WSL2。

管理员打开cmd输入

先启用“适用于 Linux 的 Windows 子系统”可选功能，然后才能在 Windows 上安装 Linux 分发版。

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

第一步：打开系统虚拟机平台
系统更新并重启后，我们就可以开始 wsl 的升级了
首先，需要打开“系统虚拟机平台”功能，在“控制面板\所有控制面板项\程序和功能”中选择“启用或者关闭Windows功能”，勾选对应选项即可：



也可以通过在管理员权限下的 cmd 或 PowerShell 中执行：

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

配置完成等待系统自动重启即可
第二步：安装WSL2


将Ubuntu for WSL 1 升级为 WSL 2
wsl.exe --set-version Ubuntu 2




第三步：将wsl2设置为默认
安装新的 Linux 分发版时，请在 Powershell 中运行以下命令，以将 WSL 2 设置为默认版本：

wsl --set-default-version 2
WSL 2 中的新增功能
WSL 2 是 WSL 中体系结构的新版本，它更改了 Linux 分发版与 Windows 进行交互的方式。 WSL 2 的主要目标是提高文件系统性能并增加完全的系统调用兼容性。 每个 Linux 分发版都可以作为 WSL 1 或 WSL 2 运行，并可随时在它们之间进行切换。 WSL 2 是对基础体系结构的一次重大改造，它使用虚拟化技术和 Linux 内核来实现其新功能
将分发版版本设置为 WSL 1 或 WSL 2


检查分配给每个已安装的 Linux 分发版的 WSL 版本：wsl -l -v

也可以使用：wsl --list --verbose


若要将分发版设置为受某一 WSL 版本支持，请运行：

wsl --set-version <distribution name> <versionNumber>


如果要使 WSL 2 成为你的默认体系结构，可以通过此命令执行该操作：

wsl --set-default-version 2


比较 WSL 2 和 WSL 1

使用 Linux 文件系统以提高性能

为了进行优化以实现最快的性能速度，请确保将项目文件存储在 Linux 文件系统（而非 Windows 文件系统）中。

例如，在存储 WSL 项目文件时：

使用 Linux 文件系统根目录：\\wsl$\Ubuntu-18.04\home\<user name>\Project

而不使用 Windows 文件系统根目录：C:\Users\<user name>\Project

通过 WSL 分发版（如 Ubuntu）使用的项目文件必须位于 Linux 根文件系统中，才能利用更快的文件系统访问速度。

可以使用 Windows应用和工具（如文件资源管理器）访问 Linux 根文件系统。 尝试打开Linux分发版（如Ubuntu），通过输入以下命令确保你位于Linux 主目录中：cd ~。 然后通过输入 explorer.exe .（不要忘记尾部的句点） ，在文件资源管理器中打开 Linux 文件系统。


管理子系统
查看子系统列表
wslconfig /list

列出可用于WSL的可用Linux发行版。如果列出了发行版，则表明已安装并可以使用。
wslconfig /list /all

列出所有发行版，包括当前不可用的发行版。它们可能正在安装，卸载或处于损坏状态。
设置默认启动的子系统
默认的WSL分发是在wsl命令行上运行时运行的分发。
wslconfig /setdefault <DistributionName>

将默认分布设置为<DistributionName>。
示例：

wslconfig /setdefault Ubuntu将我的默认发行版设置为Ubuntu。现在，当我运行wsl npm init它时，它将在Ubuntu中运行。如果我运行wsl它将打开一个Ubuntu会话。
注销并重新安装发行版
虽然可以通过Microsoft商店安装Linux发行版，但不能通过商店来卸载它们。WSL Config允许注销/卸载发行版。
取消注册还允许重新安装发行版。

**警告：**取消注册后，与该发行版关联的所有数据，设置和软件都将永久丢失。从商店中重新安装将安装发行版的完整副本。

wslconfig /unregister <DistributionName>

从WSL注销该发行版，以便可以重新安装或清理它。
例如： wslconfig /unregister Ubuntu从WSL中可用的发行版中删除Ubuntu。当我运行时wslconfig /list，它将不会列出。
要重新安装，请在Microsoft商店中找到发行版，然后选择“启动”。
参考资料：

微软官网指南