Visual Studio 代码中的 Python
使用Microsoft Python 扩展在 Visual Studio Code 中使用 Python简单、有趣且高效。该扩展使 VS Code 成为出色的 Python 编辑器,并且可以在具有各种 Python 解释器的任何操作系统上运行。它利用 VS Code 的所有功能来提供自动完成和 IntelliSense、linting、调试和单元测试,以及在 Python 环境(包括虚拟环境和 conda 环境)之间轻松切换的能力。
本文仅概述 VS Code 的 Python 扩展的不同功能。有关编辑、运行和调试代码的演练,请使用下面的按钮。
安装 Python 和 Python 扩展
本教程将指导您安装 Python 并使用扩展。您必须自己独立于扩展安装 Python 解释器。要快速安装,请使用python.org 中的 Python并从 VS Code Marketplace 安装扩展。
注意:为了帮助您开始 Python 开发,您可以使用Python 配置文件模板,其中包括有用的扩展、设置和 Python 代码片段。
安装 Python 版本后,使用Python: Select Interpreter命令选择它。如果 VS Code 没有自动找到您要查找的解释器,请参阅环境 - 手动指定解释器。
您可以通过设置来配置Python扩展。在Python 设置参考中了解更多信息。
适用于 Linux 的 Windows 子系统:如果您使用的是 Windows,WSL 是进行 Python 开发的好方法。您可以在 Windows 上运行 Linux 发行版,并且通常已经安装了 Python。与WSL扩展结合使用时,您可以在 WSL 上下文中运行时获得完整的 VS Code 编辑和调试支持。要了解更多信息,请转至在 WSL 中进行开发或尝试在 WSL 中工作教程。
运行Python代码
要体验 Python,请创建一个文件(使用文件资源管理器),命名hello.py
并粘贴以下代码:
print("Hello World")
然后,Python 扩展提供了使用当前选择的解释器运行 Python 代码的快捷方式(Python:在命令面板中选择解释器)。要运行活动的 Python 文件,请单击编辑器右上角的“在终端中运行 Python 文件”播放按钮。
您还可以使用Python: Run Selection/Line in Python Terminal命令 ( Shift+Enter )运行单行或选定的代码。如果没有选择,光标所在的行将在 Python 终端中运行。上下文菜单上提供了相同的“Python 终端中的运行选择/行”命令,用于在编辑器中进行选择。每次在终端/REPL 中运行选择或一行时,都会使用相同的终端,直到该终端关闭。同一终端也用于在终端中运行 Python 文件。如果该终端仍在运行 REPL,则应在运行 Python 文件之前退出 REPL ( exit()
) 或切换到其他终端。
Python 扩展会根据所选内容的第一个非空行自动删除缩进,并根据需要向左移动所有其他行。
如有必要,该命令将打开 Python 终端;您还可以直接使用Python: Start REPL命令打开交互式 REPL 环境,该命令使用当前选择的解释器激活终端,然后运行 Python REPL。
有关更具体的演练和运行代码的其他方法,请参阅运行代码教程。
自动完成和 IntelliSense
Python 扩展支持使用当前选择的解释器的代码完成和 IntelliSense。IntelliSense是许多功能的通用术语,包括跨所有文件以及内置和第三方模块的智能代码完成(上下文方法和变量建议)。
IntelliSense 在您键入时快速显示方法、类成员和文档。您还可以随时使用⌃Space(Windows、Linux Ctrl+Space)触发完成。将鼠标悬停在标识符上将显示有关它们的更多信息。
通过人工智能提高完成率
GitHub Copilot是一款基于 AI 的代码完成工具,可帮助您更快、更智能地编写代码。您可以使用VS Code 中的GitHub Copilot 扩展来生成代码,或从它生成的代码中学习。
GitHub Copilot 为 Python 以外的语言和各种框架提供建议,包括 JavaScript、TypeScript、Ruby、Go、C# 和 C++。
您可以在Copilot 文档中了解有关如何开始使用 Copilot 的更多信息。
棉绒
Linting 分析您的 Python 代码是否存在潜在错误,从而可以轻松导航到并纠正不同的问题。
Python 扩展可以应用许多不同的 linter,包括 Pylint、pycodestyle、Flake8、mypy、pydocstyle、prospector 和 pylama。请参阅Linting。
调试
不再需要print
语句调试!VS Code 为 Python 提供了强大的调试支持,允许您设置断点、检查变量并使用调试控制台深入了解程序如何逐步执行。调试多种不同类型的 Python 应用程序,包括多线程、Web 和远程应用程序。
有关 Python 调试的更多具体信息,例如配置设置launch.json
和实现远程调试,请参阅调试。一般 VS Code 调试信息可以在调试文档中找到。
此外,Django和Flask教程还提供了如何在 Web 应用程序上下文中实现调试的示例,包括调试 Django 模板。
环境
Python 扩展会自动检测安装在标准位置的 Python 解释器。它还检测 conda 环境以及工作区文件夹中的虚拟环境。请参阅配置 Python 环境。
当前环境显示在 VS Code 状态栏右侧:
状态栏还会指示是否未选择任何解释器:
所选环境用于 IntelliSense、自动完成、linting、格式化和任何其他与语言相关的功能。当您在终端中运行或调试 Python 时,或者使用“终端:创建新终端”命令创建新终端时,它也会被激活。
要更改当前解释器(包括切换到 conda 或虚拟环境),请在状态栏上选择解释器名称或使用 Python :选择解释器命令。
VS Code 会提示您检测到的环境列表以及您手动添加到用户设置中的任何环境(请参阅配置 Python 环境)。
Jupyter 笔记本
要在 VS Code 中启用对Jupyter 笔记本文件 ( ) 的 Python 支持,您可以安装Jupyter 扩展。Python 和 Jupyter 扩展协同工作,为您在 VS Code 中提供出色的 Notebook 体验,使您能够通过 IntelliSense 支持直接查看和修改代码单元,以及运行和调试它们。.ipynb
您还可以通过Jupyter:导出到 Python 脚本命令将笔记本转换为 Python 代码文件并打开。笔记本的单元格在 Python 文件中用#%%
注释分隔,Jupyter 扩展显示“运行单元格”或“在 CodeLens下运行”。选择 CodeLens 会启动 Jupyter 服务器并在 Python 交互窗口中运行单元格:
您还可以连接到远程 Jupyter 服务器来运行笔记本。有关更多信息,请参阅Jupyter 支持。
测试
Python 扩展支持使用 Python 内置的单元测试框架和 pytest进行测试。
为了运行测试,您必须在项目设置中启用受支持的测试框架之一。每个框架都有自己的特定设置,例如用于识别测试发现的路径和模式的参数。
一旦发现测试,VS Code 就会提供各种命令(在状态栏、命令面板和其他位置)来运行和调试测试。这些命令还允许您运行单独的测试文件和方法
配置
Python 扩展为其各种功能提供了多种设置。这些内容在其相关主题中进行了描述,例如编辑代码、Linting、调试和测试。完整列表可在设置参考中找到。
Python 配置文件模板
配置文件可让您根据当前项目或任务快速切换扩展、设置和 UI 布局。为了帮助您开始 Python 开发,您可以使用Python 配置文件模板,它是一个精心策划的配置文件,包含有用的扩展、设置和代码片段。您可以按原样使用配置文件模板,也可以将其用作起点,进一步自定义您自己的工作流程。
您可以通过配置文件>创建配置文件...下拉列表选择配置文件模板:
选择配置文件模板后,您可以查看设置和扩展,如果您不想将个别项目包含在新配置文件中,则可以将其删除。根据模板创建新配置文件后,对设置、扩展或 UI 所做的更改将保留在您的配置文件中。
其他流行的 Python 扩展
Microsoft Python 扩展提供了本文前面描述的所有功能。通过安装其他流行的 Python 扩展,可以将其他 Python 语言支持添加到 VS Code。
- 打开扩展视图 ( ⇧⌘X (Windows、Linux Ctrl+Shift+X ) )。
- 通过输入“python”来过滤扩展列表。
上面显示的扩展是动态查询的。单击上面的扩展图块以阅读说明和评论,以决定哪个扩展最适合您。在市场中查看更多内容。