现已发布!阅读 10 月份的新功能和修复。

VS Code 中的 Python 快速入门指南

Python 扩展使 Visual Studio Code 成为出色的 Python 编辑器,适用于任何操作系统,并且可以使用各种 Python 解释器。

通过安装以下内容开始使用

Gif installing the Python extension in a fresh install of VS Code

为了进一步自定义 VS Code 以适应 Python,您可以利用 Python 配置文件模板,自动安装推荐的扩展和设置。对于数据科学项目,请考虑使用 数据科学配置文件模板

Gif showing the Python profile template being installing into VS Code.

如何创建和打开 Python 项目或文件

如果您要使用 VS Code 处理现有 Python 项目,可以通过 VS Code 欢迎页或文件资源管理器视图打开文件夹或文件,或者选择文件 > 打开文件夹 (Ctrl+K Ctrl+O) 或文件 > 打开文件 (⌘O(Windows,Linux Ctrl+O).

您可以通过在 VS Code 欢迎页上选择新建文件,然后选择Python 文件,或者导航到文件 > 新建文件 () 来创建新的 Python 文件。

提示:如果您已经在 VS Code 中打开了工作区文件夹,则可以直接将新文件或文件夹添加到现有项目中。您可以使用文件资源管理器视图中顶层文件夹上的相应新建文件夹新建文件图标来创建新文件夹和文件。

UI 导览

当您第一次启动 VS Code 时,需要安装 Python 扩展才能获得 Python 特定的功能和 UI。让我们来看看安装 Python 扩展后的 UI。

Image of the Python UI highlights in VS Code.

代码操作

代码操作(也称为快速修复)用于帮助解决代码中出现警告时的错误。这些有用的提示以灯泡 (💡) 的形式显示在编辑器左侧边距。选择灯泡以显示代码操作选项。这些代码操作可以来自 Python、Pylance 或 VS Code 本身等扩展。有关代码操作的更多信息,请参见 Python 快速修复

Screenshot showing Code Actions in a Python project.

Python 命令

可以通过 命令面板 (⇧⌘P(Windows,Linux Ctrl+Shift+P) 访问 Python 命令。从命令面板中,您可以访问 VS Code 和已安装扩展的各种功能。在命令面板中输入“Python: ”以查找 Python 扩展提供的命令。

Gif demonstrating how to access Python commands in the Command Palette.

运行、调试和测试

既然您已经对 VS Code 中的 Python 有了更多了解,让我们学习如何运行、调试和测试您的代码。

运行

在 VS Code 中运行 Python 代码有几种方法。

要运行您在编辑器中打开的 Python 脚本,请选择编辑器右上角的在终端中运行 Python 文件播放按钮。

Image showing the Run Python File in Terminal play button.

您还可以通过其他方法在 VS Code 中迭代运行 Python 代码片段。

  • 选择一行或多行,然后按 Shift+Enter 或右键单击并选择在 Python 终端中运行选定内容/行。此命令便于测试文件的一部分。
  • 从命令面板 (⇧⌘P(Windows,Linux Ctrl+Shift+P) 中,选择Python: 启动 REPL命令以打开当前选择的 Python 解释器的 REPL 终端。在 REPL 中,您可以逐行输入并运行代码。

调试

调试器是一个有用的工具,它允许您检查代码执行流程,更轻松地识别错误,以及探索变量和数据在程序运行时的变化方式。您可以通过在要检查的行旁边点击边距,在 Python 项目中设置断点来开始调试。

Screenshot showing a debugger breakpoint in a Python program.

要开始调试,请按 F5 初始化调试器。由于这是您第一次调试此文件,因此将打开一个配置菜单,允许您选择要调试的应用程序类型。如果它是 Python 脚本,则可以选择Python 文件

当您的程序到达断点时,它将停止并允许您在 Python 调试控制台中跟踪数据,并使用调试工具栏遍历程序。

Gif showing how to configure the Python debugger for the first time.

要深入了解 Python 调试功能,请参见 VS Code 中的 Python 调试

测试

Python 扩展为 Unittestpytest 提供强大的测试支持。

您可以通过活动栏上的测试视图配置 Python 测试,方法是选择配置 Python 测试,然后选择您选择的测试框架。

您还可以为 Python 项目创建测试,Python 扩展将在配置您选择的框架后尝试发现这些测试。Python 扩展还允许您在测试视图中运行和调试测试,并在测试结果面板中检查测试运行输出。

Gif demonstrating test configuration, discovery, and run in the Python extension.

要全面了解测试功能,请参见 VS Code 中的 Python 测试

后续步骤

要了解如何使用流行的 Python Web 框架构建 Web 应用程序,请参见以下教程

VS Code 中的 Python 有很多值得探索的地方

  • Python 配置文件模板 - 使用精心挑选的扩展、设置和代码片段创建一个新的 配置文件
  • 编辑代码 - 了解 Python 的自动完成、IntelliSense、格式化和重构。
  • 代码整理 - 启用、配置和应用各种 Python 代码整理器。
  • 调试 - 学习本地和远程调试 Python。
  • 测试 - 配置测试环境,发现、运行和调试测试。
  • 设置参考 - 探索 VS Code 中所有与 Python 相关的设置。