設定 WSL 開發環境

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

開始使用

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

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

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

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

wsl --install

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

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

您必須在此安裝程式期間重新開機電腦。

執行 wsl 的 PowerShell 命令列 --install

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

設定 Linux 使用者名稱和密碼

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

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

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

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

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

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

注意

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

Ubuntu 命令列輸入 UNIX 使用者名稱

若要變更或重設密碼,請開啟 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 檔,包括:

Windows Terminal 螢幕擷取畫面

檔案儲存體

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

  • 將專案檔儲存在與您打算使用的工具相同的作業系統上。
    若要達到最快的效能速度,如果您使用 Linux 命令列中的 Linux 工具,將檔案儲存在 WSL 檔案系統中, (Ubuntu、OpenSUSE 等) 。 如果您在 PowerShell (Windows 命令列中工作,命令提示字元) Windows 工具,請將檔案儲存在 Windows 檔案系統中。 檔案可以跨作業系統存取,但可能會大幅降低效能。

例如,儲存 WSL 專案檔時:

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

顯示 Linux 儲存體的 Windows 檔案總管

設定您慣用的程式碼編輯器

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

使用 Visual Studio Code

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

安裝並設定 VS Code 之後,您可以輸入下列命令,以 VS Code 遠端伺服器開啟 WSL 專案: code .

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

顯示 WSL 延伸模組的 VS Code

使用 Visual Studio

請遵循此逐步指南,開始使用 Visual Studio 搭配 WSL 進行 C++ 跨平臺開發。 Visual Studio 2022 可讓您在 Windows、WSL 散發套件和來自相同 Visual Studio 實例的 SSH 連線上建置和偵錯 CMake 專案。

在 Visual Studio 2022 中選取目標系統

使用 Git 設定版本管理

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

在命令列中顯示 git 版本

使用 Docker 設定遠端開發容器

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

Docker Desktop 螢幕擷取畫面

設定資料庫

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

透過 WSL 在 Ubuntu 中執行 MongoDB

設定 GPU 加速以加快效能

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

使用 WSL 執行 GPU 加速

基本 WSL 命令

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

此外,許多命令在 Windows 和 Linux 之間互通。 以下是一些範例︰

  • 從 Windows 命令列執行 Linux 工具:開啟 PowerShell,並輸入下列命令來顯示 使用 Linux ls -la 命令的 C:\temp> 目錄內容: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 工具ipconfig.exe | grep IPv4 | cut -d: -f2 本範例示範 Windows 檔案系統上的 ipconfig 工具,用來顯示目前的 TCP/IP 網路組態值,然後只篩選成具有 grep 的 IPv4 結果,這是 Linux 工具。

掛接外部磁片磁碟機或 USB

遵循此逐步指南,以 開始在 WSL 2 中掛接 Linux 磁片

wsl 掛接命令螢幕擷取畫面

執行 Linux GUI 應用程式

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

其他資源