在 VS Code 中试试

VS Code 中 Python 快速入门

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

首先需要安装

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

为了进一步自定义适用于 Python 的 VS Code,可以利用 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: Start REPL 命令,可为当前选择的 Python 解释器打开一个 REPL 终端。在 REPL 中,可以逐行输入和运行代码。

调试

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

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 还有更多可探索的内容

  • Python 配置文件模板 - 使用精选的扩展、设置和代码片段创建新的配置文件
  • 编辑代码 - 了解 Python 的自动补全、智能感知、格式化和重构功能。
  • 代码检查 - 启用、配置和应用各种 Python linter。
  • 调试 - 了解如何在本地和远程调试 Python。
  • 测试 - 配置测试环境并发现、运行和调试测试。
  • 设置参考 - 探索 VS Code 中与 Python 相关的全部设置。