本站点文档内容均翻译自code.visualstudio.com,仅供个人学习,如有差异请以官网为准。

VS Code 中的 Python 快速入门指南

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

通过安装开始:

Gif 在 VS Code 的新安装中安装 Python 扩展

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

Gif 显示 Python 代码模板被安装到 VS Code 中。

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

如果您有一个现有的Python项目,希望在VS Code中进行编辑,您可以从VS Code欢迎页面或文件资源管理器视图中打开您的文件夹或文件,或者选择文件 > 打开文件夹 (Ctrl+K Ctrl+O) 或者文件 > 打开文件 (⌘O (Windows, Linux Ctrl+O)).

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

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

UI 之旅

当你第一次启动 VS Code 时,你需要安装 Python 扩展以获取 Python 特定的功能和用户界面。让我们在安装 Python 扩展后查看用户界面:

VS Code 中 Python UI 的亮点图像。

代码操作

代码行动(也称为快速修复)在代码中有警告时提供帮助修复问题。这些有用的提示会在编辑器的左边缘以灯泡(💡)的形式显示。选择灯泡以显示代码行动选项。这些代码行动可以来自扩展,如Python、Pylance或VS Code本身。有关代码行动的更多信息,请参见Python快速修复

截图显示在Python项目中代码操作。

Python 命令

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

Gif 展示如何在命令面板中访问 Python 命令。

运行、调试和测试

既然你已经对 VS Code 中的 Python 更加熟悉了,让我们来学习如何运行、调试和测试你的代码。

执行

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

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

图像显示在终端中运行Python文件的播放按钮。

您还可以在 VS Code 中以其他方式迭代运行 Python 代码片段:

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

调试

调试器是一个有用的工具,它允许您检查代码执行的流程,并更容易地识别错误,还可以探索在程序运行时您的变量和数据如何变化。您可以通过点击您希望检查的行旁边的空白区域来在Python项目中设置断点以开始调试。

截图显示在Python程序中设置的调试器断点。

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

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

显示如何首次配置Python调试器的Gif。

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

测试

Python扩展为单元测试pytest提供了强大的测试支持。

您可以通过活动栏上的测试视图配置Python测试,选择配置Python测试并选择您喜欢的测试框架。

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

Gif展示在Python扩展中进行测试配置、发现和运行。

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

下一步

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

在Visual Studio Code中使用Python可以探索更多的内容:

  • Python 个人资料模板 - 创建一个新的 个人资料,包含精选的扩展、设置和片段
  • 编辑代码 - 了解 Python 的自动完成、IntelliSense、格式化和重构。
  • 代码检查 - 启用、配置和应用各种Python代码检查工具。
  • 调试 - 学习如何在本地和远程调试Python。
  • 测试 - 配置测试环境并发现、运行和调试测试。
  • 设置参考 - 探索 VS Code 中所有与 Python 相关的设置。