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，请运行以下命令将 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 开发栈，否则无法运行或调试它们。而这就违背了设置一个包含所有 Python 工具和运行时的独立 Linux 实例的初衷！

在 WSL 中运行

在 WSL 终端中，确保您位于 helloWorld 文件夹中，然后输入 'code .' 以启动 Visual Studio Code。'.' 参数告诉 VS Code 打开当前文件夹。如果您使用的是 Insiders 版本的 VS Code，则需要改为运行 '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