在WSL中进行远程开发

Name: Visual Studio Code
Author: Microsoft

本教程将引导您启用Windows Subsystem for Linux (WSL)，并使用WSL扩展在WSL中运行Visual Studio Code。

先决条件

您需要Visual Studio Code已安装。

安装扩展

WSL 扩展使您能够在 Windows 子系统 for Linux (WSL) 中运行 Visual Studio Code。

安装WSL扩展

WSL 扩展

先决条件检查

安装WSL扩展后，您将在最左侧看到一个新的状态栏项目。

远程状态栏项目

远程状态栏项目可以快速显示 VS Code 正在哪个上下文中运行（本地或远程），点击该项目将显示 WSL 扩展命令。

WSL 扩展命令

启用WSL

Windows Subsystem for Linux (WSL) 是 Windows 10 的可选功能。您可以通过 Windows 功能对话框或 PowerShell 启用它。

Windows 功能对话框

在Windows搜索栏中输入“features”，以显示“Turn Windows Features on and off”对话框。向下滚动并勾选“Windows Subsystem for Linux”。

打开和关闭Windows功能对话框

选择确定，系统将提示您重启Windows。

PowerShell

如果你愿意，你可以以管理员身份打开 PowerShell 并输入：

启用-Windows可选功能 -在线 -功能名称 Microsoft-Windows-Subsystem-Linux

命令运行后，系统将提示您重启Windows。

PowerShell 提示重启

检查WSL

重启Windows后，您可以通过打开命令提示符并输入'wsl'来检查是否已启用WSL。

WSL 检查

WSL 已启用，但您尚未安装 Linux 发行版。

安装一个Linux发行版

您从 Microsoft Store 安装适用于 WSL 的 Linux 发行版。您可以使用商店应用，或在 Windows 搜索栏中搜索 Linux 发行版。选择您要安装的 Linux 发行版（例如 Ubuntu），并按照提示操作。

选择 Ubuntu 发行版

选择安装.

安装 Ubuntu

完成后，选择启动以开始使用。这将打开一个Linux终端并完成安装。由于您正在设置一个完整的Linux实例，您需要创建一个用户ID和密码。现在您正在Windows上运行Linux。

Linux 终端

Python 开发

如果你还没有安装Python，请运行以下命令在你的Linux安装中安装Python3和pip（Python的包管理器）。

超级用户权限 软件包管理工具 更新
超级用户权限 软件包管理工具 安装 Python3 Python3-pip

为了验证，请运行：

python3 --版本

从经典的“Hello World”应用程序开始。创建一个名为“helloWorld”的新文件夹，然后添加一个Python文件，当运行时会打印一条消息：

创建目录 helloWorld && 进入目录 helloWorld
打印 'print("来自 windows 上的 ubuntu 上的 python 的 hello!")' >> hello.py
python3 hello.py

在远程 Linux 环境（这个 WSL 发行版在技术上是另一个没有用户界面的机器，碰巧在你的电脑上本地运行）中，你的开发工具和体验相当有限。你可以在终端中运行 Vim 来编辑文件，或者你可以通过 Windows 侧的源编辑器来编辑源文件。\\wsl$挂载:

$\wsl$ 挂载$

这个模型的问题是，Python 运行时、pip 或任何 conda 软件包在 Windows 上都没有安装。

在 Windows 上没有 Python

记住，Python 是安装在 Linux 发行版中的，这意味着如果你在 Windows 侧编辑 Python 文件，除非你在 Windows 上安装相同的 Python 开发堆栈，否则你无法运行或调试它们。而这样就违背了设置一个包含所有 Python 工具和运行时的隔离 Linux 实例的初衷！

在WSL中运行

在WSL终端中，确保你在helloWorld文件夹中，并输入'代码 .启动Visual Studio Code。'.'参数告诉VS Code打开当前文件夹。如果你使用的是Insiders版本的VS Code，你将不得不运行'code-insiders .'相反。

注意： 如果这个命令不起作用，你可能需要重启你的终端，或者你在安装VS Code时可能没有将其添加到你的路径中。

启动 VS Code

你首先会看到一条关于“正在安装 VS Code Server”的消息（c7d83e57… 是与你刚刚安装的客户端工具匹配的 VS Code Server 的版本号）。VS Code 会在 Linux 侧安装一个小型服务器，然后桌面版 VS Code 会与之通信。该服务器随后会在 WSL 中安装和托管扩展，以便在 WSL 中安装的工具和框架的上下文中运行。换句话说，你的语言扩展将在 WSL 中安装的工具和框架上运行，而不是在 Windows 侧安装的工具和框架上运行，以获得正确的开发体验。

接下来发生的事情是 VS Code 将启动并打开Hello World文件夹。您可能会看到一个快速通知，告知您 VS Code 正在连接到 WSL，并且您可能会被提示允许访问基于 Node.js 的服务器。

安装 vscode 服务器