VS Code Python 快速入门指南
Python 扩展使 Visual Studio Code 成为出色的 Python 编辑器,它适用于任何操作系统,并可与各种 Python 解释器配合使用。
开始安装
- VS Code
- Python 解释器(任何受官方支持的 Python 版本)
- 从 VS Code 市场安装 Python 扩展

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

如何创建和打开 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 特有的功能和用户界面。让我们看看安装 Python 扩展后的界面。

代码操作
代码操作(也称为快速修复)旨在帮助您在代码出现警告时修复问题。这些有用的提示会在编辑器左侧边缘以灯泡图标(💡)显示。选择灯泡以显示代码操作选项。这些代码操作可以来自 Python、Pylance 或 VS Code 本身等扩展。有关代码操作的更多信息,请参阅 Python 快速修复。

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

运行、调试和测试
现在您已经熟悉了 VS Code 中的 Python 环境,让我们学习如何运行、调试和测试您的代码。
运行
在 VS Code 中运行 Python 代码有几种方法。
要运行编辑器中打开的 Python 脚本,请点击编辑器右上角的 在终端中运行 Python 文件 播放按钮。

此外,还有其他方法可以在 VS Code 中以迭代方式运行 Python 代码片段。
- 选择一行或多行代码,然后按 Shift+Enter,或右键点击并选择 在 Python 终端中运行选定内容/行。此命令非常适合仅测试文件的一部分。
- 从命令面板(⇧⌘P(Windows、Linux Ctrl+Shift+P))中,选择 Python: 启动 REPL 命令,为当前选定的 Python 解释器打开一个 REPL 终端。在 REPL 中,您可以逐行输入并运行代码。
调试
调试器是一个有用的工具,它允许您检查代码执行流程,更轻松地识别错误,并探索程序运行时变量和数据的变化。您可以通过在想要检查的行旁边的装订槽中点击来设置断点,从而开始调试。

要开始调试,请按 F5 初始化调试器。由于这是您第一次调试此文件,将打开一个配置菜单,允许您选择要调试的应用程序类型。如果是 Python 脚本,您可以选择 Python 文件。
当程序到达断点时,它会停止,此时您可以在 Python 调试控制台中跟踪数据,并使用调试工具栏逐步执行程序。

有关 Python 调试功能的深入了解,请参阅 在 VS Code 中调试 Python。
测试
Python 扩展为 Unittest 和 pytest 提供了强大的测试支持。
您可以通过活动栏上的“测试”视图,选择 配置 Python 测试 并选择您偏好的测试框架来配置 Python 测试。
您还可以为 Python 项目创建测试,一旦配置好选定的框架,Python 扩展就会尝试发现这些测试。Python 扩展还允许您在“测试”视图中运行和调试测试,并在“测试结果”面板中检查测试运行输出。

有关测试功能的全面介绍,请参阅 在 VS Code 中进行 Python 测试。
后续步骤
要学习如何使用流行的 Python Web 框架构建 Web 应用,请参阅以下教程:
在 Visual Studio Code 中使用 Python 还有更多值得探索的地方