编辑

在 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 搜索栏中，键入“功能”以打开 启用或关闭 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 和 pip（Python 的包管理器）安装到你的 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 打开当前文件夹。如果你使用 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