# 在 Windows 上設定 Ubuntu 虛擬機
Windows Subsystem for Linux (WSL) 是一項 Windows 功能，允許您在 Windows 上執行 Linux 發行版本，而無需使用虛擬化軟體。下圖顯示了在 Windows 上設定 WSL 所涉及的任務。
>
>
>
>
>
>
>
>
> **Figure: Workflow to set up WSL**
備註
您只能使用 WSL 編譯 Qualcomm Linux 建置。若要燒錄軟體，請參閱 [使用 QDL 工具燒錄](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-253/upgrade-rb3gen2-software.html#flash-using-windows)。
## 先決條件
在設定 WSL 之前，請執行以下操作：
- [驗證 Windows 主機電腦系統需求](https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#hopstmachinewin)
- [啟用 Windows 功能](https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#turnonwinfea)
- [設定預設的 WSL 版本](https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#setdefaultwslver)
### 驗證 Windows 主機電腦系統需求
在使用 WSL 設定 Ubuntu 虛擬機之前，請確保您的 Windows 主機電腦符合以下系統需求：
| **處理器架構** | X64 |
| --- | --- |
| **CPU 核心數** | 8 核心以上 |
| **記憶體** | 8 GB 以上 |
| **儲存空間** | 300 GB 可用空間 |
| **作業系統** | Windows 11 |
### 啟用 Windows 功能
若要啟用 *Windows Subsystem for Linux* 和 *Virtual Machine Platform* Windows 功能，請以系統管理員權限在 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 |
備註
執行命令後請重新啟動 Windows 主機電腦。
### 設定預設的 WSL 版本
若要將 Windows Subsystem for Linux 2 設定為 WSL 的預設 Linux 發行版本，請以系統管理員權限在 Windows PowerShell 中執行以下命令：
wsl --set-default-version 2
Copy to clipboard
**輸出**
有關 WSL 2 的主要差異資訊，請造訪 [https://aka.ms/wsl2](https://aka.ms/wsl2)。操作已成功完成。
## 在 WSL 中安裝 Ubuntu
Qualcomm Linux 使用 Ubuntu-22.04 Linux 發行版。若要驗證您的 Windows 主機電腦是否提供 Ubuntu 22.04 作為可用的發行版，並加以安裝，請執行以下操作：
1. 若要列出可供安裝的發行版，請在 Windows PowerShell 中執行以下命令：
>
>
> wsl --list --online
> Copy to clipboard
2. 確認清單中包含 Ubuntu 22.04 作為其中一個發行版。
>
>
> 
>
> 備註
>
>
> 如果您在清單中未看到 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 虛擬機的交換空間，請執行以下操作：
1. 開啟 Windows 檔案總管並前往 `C:Users` 目錄。
2. 執行以下操作之一：
>
>
> - 如果 `.wslconfig` 檔案已存在，請跳至步驟 3。
> - 如果 `.wslconfig` 檔案不存在，請建立一個名為 `.wslconfig` 的檔案。
3. 在文字編輯器中開啟 `.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
>
>
> 備註
>
>
> 請根據您的 Windows 主機電腦的規格設定記憶體、處理器與交換空間的數值。
4. 若要關閉 WSL，請在 Windows PowerShell 中執行以下命令：
>
>
> wsl --shutdown
> Copy to clipboard
5. 若要重新啟動 WSL，請在 Windows PowerShell 中執行以下命令：
>
>
> wsl
> Copy to clipboard
## 在 WSL 中設定 Ubuntu 設定
若要設定 WSL 環境，請在 WSL 中設定以下 Ubuntu 設定：
- [DNS 設定](https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#dnssettings)
- [Git 設定](https://docs.qualcomm.com/doc/80-70018-41TC/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#gitsettings)
- [WSL 本機設定](https://docs.qualcomm.com/doc/80-70018-41TC/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 終端機視窗時，名稱伺服器會自動還原為預設設定。若要永久儲存您對 `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。
備註
若要存取 WSL 工作區，請使用 Windows 檔案總管前往以下路徑：
\\wsl$
Copy to clipboard
## 下一步
- [同步、建置與燒錄 Qualcomm Linux](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254)
- [修復 Ubuntu 虛擬機中的網路故障](https://docs.qualcomm.com/doc/80-70018-41TC/topic/troubleshoot.html#fix-network-failures-in-the-ubuntu-vm)
Last Published: Aug 31, 2025
[Previous Topic
虛擬機器設定概述](https://docs.qualcomm.com/bundle/publicresource/80-70018-41TC/topics/getting-started.md) [Next Topic
在 Arm64 Mac 上設定 Ubuntu Server 虛擬機](https://docs.qualcomm.com/bundle/publicresource/80-70018-41TC/topics/set-up-an-ubuntu-vm-on-an-arm64-based-mac.md)