編輯

在 WSL 中進行遠端開發

Name: Visual Studio Code
Author: Microsoft

本教程將引導你啟用適用於 Linux 的 Windows 子系統 (WSL)，並使用 WSL 擴充套件在 WSL 中執行 Visual Studio Code。

先決條件

你需要安裝 Visual Studio Code。

安裝擴充套件

WSL 擴充套件允許你在適用於 Linux 的 Windows 子系統 (WSL) 中執行 Visual Studio Code。

安裝 WSL 擴充套件

WSL extension

先決條件檢查

安裝 WSL 擴充套件後，你將在最左側看到一個新的狀態列項。

Remote Status bar item

遠端狀態列項可以快速顯示 VS Code 正在執行的上下文（本地或遠端），點選該項將調出 WSL 擴充套件命令。

WSL extension commands

啟用 WSL

適用於 Linux 的 Windows 子系統 (WSL) 是 Windows 10 中的可選功能。你可以透過 Windows 功能對話方塊或 PowerShell 啟用它。

Windows 功能對話方塊

在 Windows 搜尋欄中，鍵入“features”以調出開啟或關閉 Windows 功能對話方塊。向下滾動並選中適用於 Linux 的 Windows 子系統。

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，請執行以下命令以在 Linux 安裝中安裝 Python3 和 Python 包管理器 pip。

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 新增到你的路徑中。

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