设置 Visual Studio Code WSL 扩展

已完成

通过 Visual Studio Code WSL 扩展,可直接从 Visual Studio Code 使用适用于 Linux 的 Windows 子系统 (WSL) 作为全职开发环境。 使用基于 Linux 的工具、运行时和实用工具进行开发时,你可以获得 Windows 的所有生产力。

通过此集成,开发人员可以利用各种 Linux 工具和实用工具,同时受益于 Visual Studio Code 的丰富功能。

  • 无缝集成:虽然可以使用基于 Windows 的工具编辑 Linux 中的文件,但无法在 Windows 上轻松运行或调试文件;你必须像在 Linux 上一样在 Windows 上安装所有相同的工具,从而破坏隔离的 Linux 环境的目的。

  • 统一开发体验:结合 Visual Studio Code 和 WSL 扩展,Visual Studio Code 的 UI 在 Windows 上运行,以及所有命令、扩展,甚至终端在 Linux 上运行。 你可以获得完整的 Visual Studio Code 体验(包括自动完成和调试),由 Linux 上安装的工具和编译器提供支持。

安装 Visual Studio Code WSL 扩展

Visual Studio Code 扩展标签页,其中显示 WSL 扩展的屏幕截图。

在 Visual Studio Code 中,选择窗口左侧活动栏中的“扩展”图标,转到“扩展”视图。

  1. 从侧栏中选择“扩展”。
  2. 在“扩展”视图搜索栏中,搜索“WSL”。
  3. 查找 Microsoft 发布的扩展。
  4. 选择“安装”按钮

连接到 Visual Studio Code 中的 WSL

显示 Visual Studio Code WSL 连接到 WSL 命令的屏幕截图。

  1. 在 Visual Studio Code 中,打开命令面板 (Ctrl + Shift + P),并键入“WSL: 连接到 WSL”

    • Visual Studio Code 将重新加载并连接到 WSL。
    • 请注意,右下角的远程指示器显示 Visual Studio Code 已连接到“WSL: Ubuntu”

    注意

    如果在连接到 WSL 时遇到问题,请尝试打开命令面板并键入“WSL: 使用发行版连接到 WSL”,然后选择“Ubuntu”

  2. 打开新终端 (Ctrl + `),并注意路径对应于 WSL 中的文件路径。

Visual Studio Code WSL 终端的屏幕截图。

  1. 在终端中,键入 uname,然后按 Enter;输出应为“Linux”。

在 Visual Studio Code 中从 WSL 打开 Python 项目

使用 WSL 在 Visual Studio Code 中打开的 Python 项目的屏幕截图。

  1. 打开命令面板 (Ctrl + Shift + P),并键入“WSL: 在 WSL 中打开文件夹”

  2. 选择 helloWorld 文件夹。 如果在下拉列表中看不到它,可键入路径 /home/your-username/helloWorld/。

  3. 选择“确定”。 Visual Studio Code 将重新加载和打开文件夹。

  4. 在资源管理器中 (Ctrl + Shift + E),验证是否看到 hello.py 文件。

    • 另请注意,终端 (Ctrl + `) 显示你位于 helloWorld 文件夹中。

我们现在已打开项目,并准备好使用。