在 VS Code 中试用

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 项目或文件

如果你有一个现有的 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 扩展后的用户界面:

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 应用,请参阅以下教程:

在 Visual Studio Code 中使用 Python 还有更多内容等待探索: