編輯

WSL 遠端開發

Name: Visual Studio Code
Author: Microsoft

本教學課程將引導您啟用 Windows Subsystem for Linux (WSL)，並使用 WSL 擴充功能在 WSL 中執行 Visual Studio Code。

先決條件

您需要安裝 Visual Studio Code。

安裝擴充功能

WSL 擴充功能可讓您在 Windows Subsystem for Linux (WSL) 中執行 Visual Studio Code。

安裝 WSL 擴充功能

WSL extension

先決條件檢查

安裝 WSL 擴充功能後，您會在最左側看到新的狀態列項目。

Remote Status bar item

「遠端」狀態列項目可以快速顯示 VS Code 正在哪個內容中執行 (本機或遠端)，並且按一下該項目會顯示 WSL 擴充功能命令。

WSL extension commands

啟用 WSL

Windows Subsystem for Linux (WSL) 是 Windows 10 上的選用功能。您可以透過 Windows 功能對話方塊或 PowerShell 啟用它。

Windows 功能對話方塊

在 Windows 搜尋列中，輸入 'features' 以顯示「開啟或關閉 Windows 功能」對話方塊。向下捲動並勾選「Windows Subsystem for Linux」。

Turn Windows features on and off dialog

選取「確定」，系統會提示您重新啟動 Windows。

PowerShell

如果您願意，可以以管理員身分開啟 PowerShell 並輸入

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

命令執行後，系統會提示您重新啟動 Windows。

PowerShell prompt to restart

檢查 WSL

重新啟動 Windows 後，您可以開啟命令提示字元並輸入 'wsl'，以檢查您是否已啟用 WSL。

WSL check

WSL 已啟用，但您尚未安裝 Linux 發行版。

安裝 Linux 發行版

您可以從 Microsoft Store 安裝適用於 WSL 的 Linux 發行版。您可以使用市集應用程式，或在 Windows 搜尋列中搜尋 Linux 發行版。選擇您要安裝的 Linux 發行版 (例如 Ubuntu) 並依照提示操作。

select Ubuntu distro

選取「安裝」。

install Ubuntu

完成後，選取「啟動」以開始使用。這將開啟 Linux 終端機並完成安裝。由於您正在設定完整的 Linux 執行個體，因此您需要建立使用者 ID 和密碼。您現在正在 Windows 上執行 Linux。

Linux terminal

Python 開發

如果您尚未安裝 Python，請執行下列命令，將 Python 的套件管理工具 Python3 和 pip 安裝到您的 Linux 安裝中。

sudo apt update
sudo apt install python3 python3-pip

若要驗證，請執行

python3 --version

從標準的「Hello World」應用程式開始。建立一個名為「helloWorld」的新資料夾，然後新增一個 Python 檔案，該檔案在執行時會列印訊息

mkdir helloWorld && cd helloWorld
echo 'print("hello from python on ubuntu on windows!")' >> hello.py
python3 hello.py

在遠端 Linux 環境中 (此 WSL 發行版在技術上是另一部沒有 UI 的機器，只是剛好在本機電腦上執行)，您的開發工具和體驗相當有限。您可以在終端機中執行 Vim 來編輯您的檔案，或者您可以透過 \\wsl$ 掛載在 Windows 端編輯來源

$\wsl$ mount$

此模型的缺點是 Python 執行階段、pip 或任何 conda 套件都未安裝在 Windows 上。

no Python on Windows

請記住，Python 是安裝在 Linux 發行版中的，這表示如果您在 Windows 端編輯 Python 檔案，除非您在 Windows 上安裝相同的 Python 開發堆疊，否則您無法執行或偵錯它們。而這就失去了設定具有所有 Python 工具和執行階段的隔離 Linux 執行個體的目的！

在 WSL 中執行

在 WSL 終端機中，請確定您位於 helloWorld 資料夾中，然後輸入 'code .' 以啟動 Visual Studio Code。'.' 引數會告知 VS Code 開啟目前資料夾。如果您使用 Insiders 版本的 VS Code，則必須改為執行 'code-insiders .'。

注意： 如果此命令無效，您可能需要重新啟動終端機，或者您可能在安裝時未將 VS Code 新增至您的路徑。

launch VS Code

您首先會看到一則關於「安裝 VS Code Server」的訊息 (c7d83e57… 編號是 VS Code Server 的版本，與您剛安裝的用戶端工具相符)。VS Code 正在 Linux 端安裝一個小型伺服器，桌面 VS Code 稍後將與之通訊。然後，該伺服器將在 WSL 中安裝和託管擴充功能，以便它們在 WSL 中安裝的工具和框架的內容中執行。換句話說，您的語言擴充功能將針對 WSL 中安裝的工具和框架執行，而不是針對 Windows 端安裝的工具和框架執行，這才是正確開發體驗應有的方式。

接下來發生的事情是 VS Code 將啟動並開啟 helloWorld 資料夾。您可能會看到快速通知，告知您 VS Code 正在連線到 WSL，並且可能會提示您允許存取以 Node.js 為基礎的伺服器。

installing vscode server