# 在 Windows 上搭建 Ubuntu VM
Windows Subsystem for Linux (WSL) 是一项 Windows 功能，允许您在不使用虚拟化软件的情况下在 Windows 上运行 Linux 分发版本。下图展示了在 Windows 上设置 WSL 的任务流程：
>
>
>
>
>
>
> **图：设置 WSL 的工作流**
Note
只能使用 WSL 编译 Qualcomm Linux 软件。要刷写软件，请参见[使用 QDL 工具刷写](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-251/upgrade-rb3gen2-software.html#panel-0-VWJ1bnR1tab$flash-using-the-qdl-tool)。
## 在 Windows 上搭建 Ubuntu VM 的前提条件
在设置 WSL 之前，请执行以下操作：
- [验证 Windows 主机系统要求](https://docs.qualcomm.com/doc/80-70022-41SC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#hopstmachinewin)
- [启用 Windows 功能](https://docs.qualcomm.com/doc/80-70022-41SC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#turnonwinfea)
- [设置默认 WSL 版本](https://docs.qualcomm.com/doc/80-70022-41SC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#setdefaultwslver)
### 验证 Windows 主机系统要求
在使用 WSL 搭建 Ubuntu VM 之前，请确保您的 Windows 主机满足下表中列出的系统要求：
表：Windows 主机系统要求
| **处理器架构** | **CPU 核数量** | **RAM** | **存储** | **操作系统** |
| --- | --- | --- | --- | --- |
| X64 | 8 个或更多 | 8 GB 或更大 | 300 GB 可用空间 | Windows 11 |
### 打开 Windows 功能
要启用 Windows 的 *Windows Subsystem for Linux* 和 *Virtual Machine Platform* 功能，请执行以下操作：
1. 使用管理员权限在 Windows PowerShell 中运行以下命令：
| Windows 功能 | 命令 |
| --- | --- |
| Windows Subsystem for Linux | Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Copy to clipboard |
| Virtual Machine Platform | Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
Copy to clipboard |
2. 运行命令后，请重启 Windows 主机。
### 设置默认 WSL 版本
要将 Windows Subsystem for Linux 2 设置为 WSL 的默认 Linux 分发版本，请以管理员权限在 Windows PowerShell 中运行以下命令：
wsl --set-default-version 2
Copy to clipboard
**输出**
For information on key differences with WSL 2 please visit [https://aka.ms/wsl2](https://aka.ms/wsl2). The operation completed successfully.
## 在 WSL 中安装 Ubuntu
Qualcomm Linux 使用 Ubuntu-22.04 Linux 分发版本。要验证 Ubuntu 22.04 分发版本在您的 Windows 主机上是否可用并进行安装，请执行以下操作：
1. 要列出可供安装的分发版本，请在 Windows PowerShell 中运行以下命令：
>
>
> wsl --list --online
> Copy to clipboard
2. 请确认 Ubuntu 22.04 是否包含在分发版本列表中。
>
>
> 
>
> Note
>
>
> 如果在分发版本列表中未能找到 Ubuntu 22.04，请联系 Microsoft 支持。
3. 要更新 WSL，请运行以下命令：
>
>
> wsl --update
> Copy to clipboard
4. 要安装 Ubuntu 22.04 LTS，请运行以下命令：
>
>
> wsl --install -d Ubuntu-22.04
> Copy to clipboard
5. 安装完成后，请为已安装的 Ubuntu 22.04 Linux 分发版本设置用户名和密码。
## 配置 WSL 全局设置
要配置 WSL 全局设置（如 Ubuntu VM 的内存、处理器和交换存储空间），请执行以下操作：
1. 打开 Windows 文件资源管理器，转到 `C: Users` 目录。
2. 请执行以下操作之一：
>
>
> - 如果 `.wslconfig` 文件已存在，请跳至步骤 3。
> - 如果 `.wslconfig` 文件不存在，请创建名为 `.wslconfig` 的文件。
3. 为确保内存、处理器和交换空间大小的值与 Windows 主机的规格一致，请使用文本编辑器打开 `.wslconfig` 文件。
4. 将以下文本复制到 `.wslconfig` 文件并保存：
>
>
> # Settings apply across all Linux distributions running on WSL 2
> [wsl2]
> # Limits VM memory to use no more than 4 GB, this can be set as whole numbers using GB or MB
> memory=64GB
> # Sets the VM to use two virtual processors
> processors=16
> # Sets amount of swap storage space to 8GB, default is 25% of available RAM
> swap=64GB
> # Sets swapfile path location, default is %USERPROFILE%\AppData\Local\Temp\swap.vhdx
> swapfile=C:\\temp\\wsl-swap.vhdx
> # Enable experimental features
> [experimental]
> # Automatically releases cached memory after detecting idle CPU usage. Set to gradual for slow release, and dropcache for instant release of cached memory.
> autoMemoryReclaim=dropcache
> Copy to clipboard
5. 要关闭 WSL，请在 Windows PowerShell 中运行以下命令：
>
>
> wsl --shutdown
> Copy to clipboard
6. 要重启 WSL，请在 Windows PowerShell 中运行以下命令：
>
>
> wsl
> Copy to clipboard
## 配置 WSL 中的 Ubuntu 设置
要搭建 WSL 环境，请在 WSL 中配置以下 Ubuntu 设置：
- [DNS 设置](https://docs.qualcomm.com/doc/80-70022-41SC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#dnssettings)
- [Git 设置](https://docs.qualcomm.com/doc/80-70022-41SC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#gitsettings)
- [WSL 本地设置](https://docs.qualcomm.com/doc/80-70022-41SC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#wsllocalsettings)
### DNS 设置
要为 WSL 配置 DNS 设置，请使用 `resolv.conf` 文件。
1. 在 Linux 终端窗口中，使用 `sudo` 命令在 `/etc/resolv.conf` 文件中添加以下内容：
sudo rm /etc/resolv.conf
sudo bash -c 'echo "nameserver 8.8.8.8" > /etc/resolv.conf'
Copy to clipboard
2. 关闭 Linux 终端窗口后，nameserver 会自动恢复为默认的 nameserver 设置。要永久保存对 `resolv.conf` 文件所做的更改，请运行以下命令：
sudo chattr -f +i /etc/resolv.conf
Copy to clipboard
3. 要更改写入权限并更新 `resolv.conf` 文件，请运行以下命令：
sudo chattr -f -i /etc/resolv.conf
Copy to clipboard
### Git 设置
要启用对 Git 的长路径支持，请在 Linux 终端窗口中运行以下命令：
git config --global core.longpaths true
Copy to clipboard
### WSL 本地设置
要为安装的 Ubuntu Linux 分发版本配置本地设置，请使用 `wsl.conf` 文件。每次打开 WSL 时都会自动应用 wsl.conf 文件中的设置。
1. 在 Linux 终端窗口中，使用 `sudo` 命令在 `/etc/wsl.conf` 文件中添加以下内容：
[network]
generateResolvConf = false
[automount]
options = "metadata"
[boot]
command = service docker start
Copy to clipboard
2. 在 Windows PowerShell 中，运行以下命令以重启 WSL：
wsl --shutdown
Copy to clipboard
## 可选：更改 Ubuntu 安装驱动器
Ubuntu 默认安装在 C 盘。如果 Windows 主机上的 C 盘没有足够的磁盘空间用于编译，您可以将 Ubuntu 安装更改到其他驱动器：
要将 Ubuntu 安装更改到另一个驱动器上，请执行以下操作：
1. 打开 Add or Remove Programs，在列表中找到 Ubuntu 安装。
2. 在 Control Panel 中，选择 Programs > Programs and Features。
3. 右键点击需要更改驱动器的 Ubuntu 安装，然后选择 Uninstall 或 Uninstall/Change。
此时将显示以下对话框。
4. 选择 Move。
5. 选择 Ubuntu 安装的目标驱动器，然后选择 Move。
6. 要访问 WSL 工作区，请使用 Windows 文件资源管理转到以下路径：
\\wsl$
Copy to clipboard
## 后续步骤
- [同步、编译和刷写 Qualcomm Linux](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-254)
- [修复 Ubuntu VM 中的网络故障](https://docs.qualcomm.com/doc/80-70022-41SC/topic/troubleshoot.html#fix-network-failures-in-the-ubuntu-vm)
Last Published: Nov 02, 2025
[Previous Topic
虚拟机搭建概述](https://docs.qualcomm.com/bundle/publicresource/80-70022-41SC/topics/getting-started.md) [Next Topic
在 Arm64 Mac 上搭建 Ubuntu Server VM](https://docs.qualcomm.com/bundle/publicresource/80-70022-41SC/topics/set-up-an-ubuntu-vm-on-an-arm64-based-mac.md)