在 WSL 中进行远程开发
本教程将引导您启用 适用于 Linux 的 Windows 子系统 (WSL),并使用 WSL 扩展在 WSL 中运行 Visual Studio Code。
先决条件
您需要安装 Visual Studio Code。
安装扩展
WSL 扩展允许您在适用于 Linux 的 Windows 子系统 (WSL) 中运行 Visual Studio Code。
先决条件检查
安装 WSL 扩展后,您会在最左侧看到一个新的状态栏项。
远程状态栏项可以快速显示 VS Code 正在哪个上下文(本地或远程)中运行,单击该项将调出 WSL 扩展命令。
启用 WSL
适用于 Linux 的 Windows 子系统 (WSL) 是 Windows 10 中的一个可选功能。您可以通过 Windows 功能对话框或 PowerShell 启用它。
Windows 功能对话框
在 Windows 搜索栏中,输入“features”以调出启用或关闭 Windows 功能对话框。向下滚动并勾选适用于 Linux 的 Windows 子系统。
选择确定,系统将提示您重新启动 Windows。
PowerShell
如果您愿意,可以以管理员身份打开 PowerShell 并输入
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
命令运行后,系统将提示您重新启动 Windows。
检查 WSL
重新启动 Windows 后,您可以打开命令提示符并输入“wsl”来检查是否已启用 WSL。
WSL 已启用,但您尚未安装 Linux 发行版。
安装 Linux 发行版
您可以从 Microsoft Store 安装适用于 WSL 的 Linux 发行版。您可以使用商店应用,或在 Windows 搜索栏中搜索 Linux 发行版。选择要安装的 Linux 发行版(例如 Ubuntu)并按照提示操作。
选择安装。
完成后,选择启动以开始。这将打开一个 Linux 终端并完成安装。由于您正在设置一个完整的 Linux 实例,因此需要创建一个用户 ID 和密码。您现在正在 Windows 上运行 Linux。
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 侧编辑源文件。
这种模式的问题是 Python 运行时、pip 或任何 conda 包都没有安装在 Windows 上。
请记住,Python 是安装在 Linux 发行版中的,这意味着如果您在 Windows 侧编辑 Python 文件,除非您在 Windows 上安装相同的 Python 开发堆栈,否则无法运行或调试它们。这违背了拥有一个独立 Linux 实例并设置所有 Python 工具和运行时的目的!
在 WSL 中运行
在 WSL 终端中,确保您位于 helloWorld 文件夹中,然后键入 'code .'
以启动 Visual Studio Code。'.'
参数告诉 VS Code 打开当前文件夹。如果您使用的是 Insiders 版本的 VS Code,则必须运行 'code-insiders .'
。
注意:如果此命令不起作用,您可能需要重新启动终端,或者在安装 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 的服务器。
现在,当您将鼠标悬停在 hello.py
上时,您将获得正确的 Linux 路径。
集成终端
运行终端 > 新建终端 (⌃` (Windows, Linux Ctrl+`)) 以打开新的终端实例。
您将再次从 Windows 上运行的 VS Code 启动 WSL 中的 bash shell 新实例。
提示:在状态栏的左下角,您可以看到已连接到您的 WSL: Ubuntu 实例。
编辑和调试
安装 Python 扩展(及其他工具)
单击 hello.py
以打开它进行编辑。系统将提示您推荐一个扩展,在本例中是安装 Microsoft Python 扩展,它将为您提供丰富的编辑和调试体验。继续选择安装,如果提示,请重新加载。
为了证明该扩展已安装在 WSL 中,请再次打开扩展视图 (⇧⌘X (Windows, Linux Ctrl+Shift+X))。您将看到一个名为WSL: Ubuntu – 已安装的部分,并且可以看到 WSL 端安装的任何扩展。
重新加载后,您还会收到提示,告知 pylint 代码检查器未安装。代码检查器用于在源代码中显示错误和警告。继续选择安装。
现在,当您编辑代码时,您会获得丰富的颜色高亮和代码补全功能。
当您保存文件 (⌘S (Windows, Linux Ctrl+S)) 时,文件上将出现代码检查错误和警告。
调试
设置好工具后,让我们更进一步。通过单击行号左侧的边槽,或者将光标放在该行并按 F9,在 hello.py 的第 1 行设置一个断点。
现在,按 F5 运行您的应用程序。系统会询问您如何运行应用程序,由于这是一个简单的文件,只需选择Python 文件即可。
应用程序将启动,您将命中断点。您可以检查变量、创建监视器和导航调用堆栈。
按 F10 单步执行,您将在调试控制台中看到 print 语句的输出。
您将获得 Visual Studio Code 的完整开发体验,使用安装在 WSL 中的 Linux 实例。
如果您想在 WSL 中打开另一个文件夹,请打开文件菜单并选择打开文件夹。您将获得一个针对 Linux 文件系统的最小文件和文件夹导航器,而不是 Windows 文件系统。
如果您想切换回 Windows,请选择显示本地选项,您将获得标准的 Windows 文件打开对话框。
结束您的 WSL 连接
您可以通过文件 > 关闭远程连接来结束 WSL 会话并返回到本地运行 VS Code。
恭喜
恭喜,你已成功完成本教程!
接下来,查看其他远程开发扩展。
或者通过安装远程开发扩展包获取所有这些扩展。