# WSL

**Repository Path**: chend2018/wsl

## Basic Information

- **Project Name**: WSL
- **Description**: Windows Subsystem for Linux
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-03-05
- **Last Updated**: 2025-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Windows Subsystem for Linux

- https://docs.microsoft.com/zh-cn/windows/wsl/basic-commands
- https://docs.microsoft.com/zh-cn/windows/wsl/install

## 在计算机的 BIOS 中启用虚拟化技术

在计算机的 BIOS 中已启用虚拟化。此操作的说明因计算机而异，并且很可能在 CPU 相关选项下。

设置方法是进入BIOS后，找到`Configuration`选项或者`Security`选项，然后选择`Virtualization`、
`Intel Virtual Technology`或者`SVM Mode`等，将`Disabled`修改为`Enabled`。

设置结果如下：

![BIOS启用虚拟化技术](BIOS-Virtualization-Setting.png)

## 启用 WSL

`以管理员身份运行` 命令提示符（`cmd`），并执行命令：

```shell
DISM.exe /?

DISM.exe /Online /Enable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux /All /NoRestart
```

## 更新到 WSL 2

若要更新到 WSL 2，需要运行 Windows 10。

- 要求
  - 对于 x64 系统：版本 1903 或更高版本，采用内部版本 18362 或更高版本。
  - 对于 ARM64 系统：版本 2004 或更高版本，采用内部版本 19041 或更高版本。
  - 低于 18362 的版本不支持 WSL 2。使用 [Windows Update 助手](https://www.microsoft.com/software-download/windows10) 更新 Windows 版本。

或者 Windows 11。

## 启用虚拟机平台

安装 WSL 2 之前，必须启用`虚拟机平台`可选功能。

`以管理员身份运行` 命令提示符（`cmd`），并执行命令：

```shell
DISM.exe /Online /Enable-Feature /FeatureName:VirtualMachinePlatform /All /NoRestart
```

**重启**计算机，以完成 WSL 安装并更新到 WSL 2。

## 下载 Linux 内核更新包

下载并安装[适用于 x64 计算机的 WSL2 Linux 内核更新包](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi)

## 将 WSL 2 设置为默认版本

`以管理员身份运行` 命令提示符（`cmd`），并执行命令：

```shell
wsl.exe --update

wsl.exe --set-default-version 2
```

## 安装所选的 Linux 发行版

### 安装 [Debian](https://salsa.debian.org/debian/WSL)

请见[README.md](debian/README.md)。

## 更新 WSL

```shell
wsl.exe --update
```

## 检查 WSL 状态

```shell
wsl.exe --status
```

## 检查 WSL 版本

```shell
wsl.exe --version
```

## 系统迁移或备份

可以通过`wsl`命令提供的`导出`、`导入`功能，对WSL子系统进行迁移或备份。

- 导出

以导出`Debian`为例。

```shell
wsl.exe --help
wsl.exe --list --verbose

wsl.exe --shutdown
wsl.exe --export Debian D:\WSL\Debian.tar
```

- 导入

以导出`Debian`为例。

```shell
wsl.exe --unregister Debian

wsl.exe --import Debian D:\WSL\Debian D:\WSL\Debian.tar
```

通过这种方法，可以对虚拟磁盘VHD文件（如`ext4.vhdx`）进行空间回收。

## 卸载

- 列出已安装的发行版

```shell
wsl.exe --list --verbose
```

- 注销需要卸载的发行版

以`Debian`为例：

```shell
wsl.exe --shutdown
wsl.exe --unregister Debian
```

## 文件系统

WSL 2 使用虚拟硬盘 (VHD) 来存储 Linux 文件。 在 WSL 2 中，VHD 在 Windows 硬盘驱动器上表示为`.vhdx`文件。

WSL 2 VHD 使用 ext4 文件系统。

相关说明请见：[扩展 WSL 2 虚拟硬盘的大小](https://docs.microsoft.com/zh-cn/windows/wsl/compare-versions#expanding-the-size-of-your-wsl-2-virtual-hard-disk)

### WSL 2 分发版访问 Windows 文件系统

WSL 2 分发版安装完成后，Windows 的文件系统挂载在`/mnt`目录下，如`/mnt/c`为 Windows C 盘，`/mnt/d` 为 Windows D 盘……

### 访问 Linux 根文件系统

可以使用 Windows 应用和工具（如文件资源管理器）访问 Linux 根文件系统。

尝试打开 Linux 分发版（如`Debian`），请在`文件资源管理器`输入：`\\wsl$`或者`\\wsl$\Debian`。