設定 WSL 開發環境

設定 WSL 開發環境的最佳作法逐步指南。 瞭解如何執行命令來安裝使用 Ubuntu 或可設定為安裝其他 Linux 發行版本的預設 Bash 殼層、使用基本 WSL 命令、設定 Visual Studio Code 或 Visual Studio、Git、Windows 認證管理員、MongoDB、Postgres 或 MySQL 等資料庫、設定 GPU 加速、執行 GUI 應用程式等等。

開始使用

Windows 子系統 Linux 版隨附於 Windows 作業系統，但您必須啟用並安裝 Linux 發行版本，才能開始使用。

若要使用簡化的 --install 命令，您必須執行最新的 Windows 組建 (組建 20262 以上版本)。 若要檢查您的版本及組建號碼，請選取 [Windows 標誌鍵 + R]、輸入 winver，然後選取 [確定]。 您可以使用 [設定] 功能表或 Windows 更新小幫手來更新。

如果您想要安裝 Ubuntu 以外的 Linux 發行版本，或想要手動完成這些步驟，請參閱 WSL 安裝頁面以取得詳細資料。

開啟 PowerShell (或 Windows 命令提示字元)，然後輸入：

wsl --install

--install 命令會執行下列動作：

• 啟用選用的 WSL 和虛擬機器平台元件
• 下載並安裝最新的 Linux 核心
• 將 WSL 2 設定為預設值
• 下載並安裝 Ubuntu Linux 發行版本 (可能需要重新開機)

在此安裝程式期間，您必須重新啟動電腦。

如果您遇到任何問題，請查看安裝疑難排解一文。

設定您的 Linux 使用者名稱和密碼

完成使用 WSL 安裝 Linux 發行版本的程序後，請使用 [開始] 功能表開啟發行版本 (預設為 Ubuntu)。 系統會要求您為 Linux 發行版本建立 [使用者名稱] 和 [密碼]。

• 此使用者名稱和密碼是每個各自 Linux 發行版本專屬，不會影響您的 Windows 使用者名稱。

• 請注意，輸入 [密碼] 時，畫面上不會顯示任何專案。 這稱為盲目輸入。 您不會看到您正在輸入的內容，這完全正常。

• 一旦您建立使用者名稱和密碼，帳戶就會是您散發套件的預設使用者，而且會在啟動時自動登入。

• 此帳戶將會被視為 Linux 系統管理員，並且能夠執行 sudo (超級使用者執行) 系統管理命令。

• 在 WSL 上執行的每個 Linux 發行版本都有自己的 Linux 使用者帳戶和密碼。 每當您新增散發套件、重新安裝或重設時，都必須設定 Linux 使用者帳戶。

注意

隨 WSL 一起安裝的 Linux 發行版本由每個使用者安裝，無法與其他 Windows 使用者帳戶共用。 遇到使用者名稱錯誤嗎？ StackExchange：我應該在 Linux 的使用者名稱中使用或不使用哪些字元？

若要變更或重設您的密碼，請開啟 Linux 發行版本，然後輸入下列命令：passwd。 系統會要求您輸入目前的密碼，然後要求您輸入新密碼，然後確認您的新密碼。

如果您忘記 Linux 散發套件的密碼：

1. 開啟 PowerShell，並使用下列命令進入預設 WSL 散發套件的根目錄：wsl -u root

   如果您需要在不是預設值的散發套件上更新忘記的密碼，請使用命令：wsl -d Debian -u root，以目標散發套件的名稱取代 Debian。

2. 在 PowerShell 中的根層級開啟 WSL 散發套件之後，您就可以使用此命令來更新您的密碼：passwd <username>，其中 <username> 是發行版本中您已忘記密碼的帳戶使用者名稱。

3. 系統會提示您輸入新的 UNIX 密碼，然後確認該密碼。 一旦系統告知您密碼已成功更新，請使用命令關閉 PowerShell 中的 WSL：exit。

更新和升級套件

建議您使用發行版本慣用的套件管理員，定期更新和升級套件。 針對 Ubuntu 或 Debian，請使用下列命令：

sudo apt update && sudo apt upgrade

Windows 不會自動更新或升級您的 Linux 發行版本。 這是大部分 Linux 使用者希望能自行控制的工作。

新增其他發行版本

若要新增其他 Linux 發行版本，您可以透過 Microsoft Store、透過 --import 命令安裝，或側載您自己的自訂發行版本。 您也可以設定自訂 WSL 映像，以在整個企業公司散發。

設定 Windows Terminal

Windows Terminal 可以使用命令列介面執行任何應用程式。 其主要功能包括多個索引標籤、窗格、Unicode 和 UTF-8 字元支援、GPU 加速文字轉譯引擎，以及讓您能夠建立自己的佈景主題並自訂文字、色彩、背景和快速鍵。

每當安裝新的 WSL Linux 發行版本時，就會在 Windows Terminal 內為其建立新的執行個體，您可以針對自己的喜好設定自訂該執行個體。

建議您搭配 Windows Terminal 使用 WSL，特別是當您打算使用多個命令列時。 請參閱 Windows Terminal 文件，以取得設定和自訂喜好設定的說明，包括：

• 從 Microsoft Store 安裝 Windows Terminal 或 Windows Terminal (預覽版)
• 使用命令選擇區
• 設定 像是鍵盤快捷方式的自定義動作 ，讓您的 terminal 喜好設定變得自然
• 設定預設啟動設定檔
• 自訂外觀：佈景主題、色彩配置、名稱和起始目錄、背景影像等。
• 瞭解如何使用 命令行自變數， 例如開啟 terminal 多個命令行分割成視窗窗格或索引標籤
• 瞭解搜尋功能
• 尋找秘訣和訣竅，例如如何重新命名或設定索引標籤的色彩、使用滑鼠互動或啟用「地震模式」
• 尋找如何設定自訂命令提示字元、SSH 設定檔或索引標籤標題的教學課程
• 尋找自定義terminal資源庫和疑難解答指南

檔案儲存體

• 若要在 Windows 檔案總管中開啟 WSL 專案，請輸入：explorer.exe .
  請務必在命令結尾新增句點，以開啟目前的目錄。

• 將專案檔儲存在與您計畫使用之工具相同的作業系統上。
  如需最快的效能速度，如果您是在 Linux 命令列 (Ubuntu、OpenSUSE 等) 中使用 Linux 工具處理這些檔案，請將檔案儲存在 WSL 檔案系統中。 如果您使用 Windows 工具在 Windows 命令列 (PowerShell、命令提示字元) 中運作，請將檔案儲存在 Windows 檔案系統中。 檔案可以跨作業系統存取，但可能會大幅降低效能。

例如，儲存 WSL 專案檔時：

• 使用 Linux 檔案系統根目錄：\\wsl$\<DistroName>\home\<UserName>\Project
• 不是 Windows 檔案系統根目錄：C:\Users\<UserName>\Project 或 /mnt/c/Users/<UserName>/Project$

安裝您慣用的程式碼編輯器

建議您使用 Visual Studio Code 或 Visual Studio，因為它們直接支援使用 WSL 進行遠端開發和偵錯。 Visual Studio Code 可讓您使用 WSL 作為功能完整的開發環境。 Visual Studio 提供 C++ 跨平台開發的原生 WSL 支援。

使用 Visual Studio Code

請遵循此逐步指南以開始使用 Visual Studio Code 與 WSL，其中包括安裝遠端開發延伸模組套件。 此延伸模組可讓您執行 WSL、SSH 或開發容器，以使用完整的 Visual Studio Code 功能集進行編輯和偵錯。 在不同、個別的開發環境之間快速交換並進行更新，而不必擔心影響本機電腦。

安裝並設定 VS Code 之後，您可用 VS Code 遠端伺服器開啟 WSL 專案，請輸入：code .

請務必在命令結尾新增句點，以開啟目前的目錄。

使用 Visual Studio

請遵循此逐步指南，開始使用 Visual Studio 與 WSL for C++ 跨平台開發。 Visual Studio 2022 可讓您在 Windows、WSL 發行版本和來自相同 Visual Studio 執行個體的 SSH 連線上建置和偵錯 CMake 專案。

使用 Git 設定版本管理

請遵循此逐步指南，開始在 WSL 上使用 Git，並將專案連線至 Git 版本控制系統，以及使用認證管理員進行驗證、使用 Git Ignore 檔案、瞭解 Git 行結尾，以及使用內建至 VS Code 的 Git 命令。

使用 Docker 設定遠端開發容器

請遵循此逐步指南，開始在 WSL 2 上使用 Docker 遠端容器，並使用適用於 Windows 的 Docker Desktop 將您的專案連線到遠端開發容器。

設定資料庫

請遵循此逐步指南，開始使用 WSL 上的資料庫，並將專案連線到 WSL 環境中的資料庫。 開始使用 MySQL、PostgreSQL、MongoDB、Redis、Microsoft SQL Server 或 SQLite。

設定 GPU 加速以加快效能

請遵循此逐步指南，在 WSL 中設定 GPU 加速機器學習訓練，並利用電腦的 GPU (圖形處理單元) 加速效能繁重的工作負載。

基本 WSL 命令

您透過 WSL 安裝的 Linux 發行版本最適合使用 PowerShell 或 Windows 命令提示字元 (CMD) 進行管理。 如需使用 WSL 時要熟悉的基本命令清單，請參閱 WSL 命令參考指南。

此外，許多命令在 Windows 和 Linux 之間互通。 以下提供幾個範例：

• 從 Windows 命令列執行 Linux 工具：開啟 PowerShell，並輸入下列命令來顯示C:\temp>使用 Linux ls -la命令的目錄內容：wsl ls -la

• 混合 Linux 和 Windows 命令：在此範例中，Linux 命令 ls -la 用來列出目錄中的檔案，然後使用 PowerShell 命令 findstr 來篩選包含「git」字組的結果：wsl ls -la | findstr "git"。 您也可以將 Windows dir 命令與 Linux grep 命令混合使用：dir | wsl grep git。

• 直接從 WSL 命令列執行 Windows 工具：<tool-name>.exe 例如，若要開啟 .bashrc 檔案 (每當 Linux 命令列啟動時執行的殼層指令碼)，請輸入：notepad.exe .bashrc

• 使用 Linux Grep 工具執行 Windows ipconfig.exe 工具：從 Bash 輸入 命令 ipconfig.exe | grep IPv4 | cut -d: -f2 ，或從 PowerShell 輸入 ipconfig.exe | wsl grep IPv4 | wsl cut -d: -f2 此範例會示範 Windows 檔案系統上的 ipconfig 工具，用來顯示目前的 TCP/IP 網路組態值，然後將它篩選為僅使用 grep 的 IPv4 結果，Linux 工具。

掛接外部磁碟機或 USB

請遵循此逐步指南，開始在 WSL 2 中掛接 Linux 磁片。

執行 Linux GUI 應用程式

請遵循本教學課程，瞭解如何在 WSL 上設定及執行 Linux GUI 應用程式。

其他資源

• 在 Windows 上設定您的開發環境：深入瞭解如何為您的慣用語言或架構設定開發環境，例如 React、Python、NodeJS、Vue 等。
• 疑難排解：尋找常見問題、報告錯誤的位置、要求新功能的位置，以及如何參與文件編輯。
• 常見問題集：尋找常見問題集清單。
• 版本資訊：檢閱 WSL 版本資訊，以取得過去組建更新的歷程記錄。 您也可以找到 WSL Linux 核心的版本資訊。