VS Code 中 Python 的快速入门指南

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

通过安装开始:

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

为了进一步为Python定制VS Code,您可以利用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 中打开了一个工作区文件夹,你可以直接将新文件或文件夹添加到现有项目中。你可以通过在文件资源管理器视图中的顶级文件夹上使用相应的新建文件夹新建文件图标来创建新文件夹和文件。

用户界面导览

当你第一次启动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: Start REPL命令,为当前选定的Python解释器打开一个REPL终端。在REPL中,您可以逐行输入并运行代码。

调试

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

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

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

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

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

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

测试

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

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

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

Gif演示了Python扩展中的测试配置、发现和运行。

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

下一步

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

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

  • Python profile template - 使用一组精选的扩展、设置和代码片段创建一个新的profile
  • 编辑代码 - 了解Python的自动完成、IntelliSense、格式化和重构。
  • Linting - 启用、配置和应用各种Python linter。
  • 调试 - 学习如何在本地和远程调试Python。
  • Testing - 配置测试环境并发现、运行和调试测试。
  • Settings reference - 探索VS Code中与Python相关的所有设置。