在 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 功能」對話方塊。向下捲動並勾選「適用於 Linux 的 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，請執行下列指令，將 Python3 以及 Python 套件管理員 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 開發堆疊，否則無法執行或偵錯它們。而這就違背了建立一個隔離的 Linux 執行個體並配置所有 Python 工具與執行階段的初衷！

在 WSL 中執行

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

注意：如果此指令無效，您可能需要重新啟動終端機，或者在安裝 VS Code 時未將其加入到您的 PATH 環境變數中。

launch VS Code

您首先會看到「Installing 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