如何在 Windows 上的 Visual Studio 中安装 Python 支持

适用范围:yesVisual Studio noVisual Studio for Mac noVisual Studio Code

若要安装针对 Visual Studio 的 Python 支持(亦称为“针对 Visual Studio 的 Python 工具 (PTVS)”),请按照 Visual Studio 版本对应部分中的说明操作:

若要在执行安装步骤后快速测试 Python 支持,请按 Alt+I 并输入 2+2 打开 Python 交互式窗口 。 如果看不到输出 4,请重新检查步骤。

提示

Python 工作负载包括有用的 Cookiecutter 扩展,扩展提供图形用户界面以发现模板、输入模板选项及创建项目和文件。 有关详细信息,请参阅使用 Cookiecutter

注意

目前尚未在 Visual Studio for Mac 中提供 Python 支持,但可在 Mac 和 Linux 上通过 Visual Studio Code 获取相应支持。 请参阅问题和解答

Visual Studio 2022

Visual Studio 2019

  1. 下载并运行最新 Visual Studio 安装程序。 如果已安装 Visual Studio,则运行 Visual Studio 安装程序,选择“修改”选项(请参阅修改 Visual Studio),并转到步骤 2。

    提示

    Community Edition 适用于个体开发者、课堂学习、学术研究和开放源代码开发。 对于其他用户,请安装 Visual Studio 2022 ProfessionalVisual Studio 2022 Enterprise

    提示

    Community Edition 适用于个体开发者、课堂学习、学术研究和开放源代码开发。 对于其他用途,请安装 Visual Studio 2019 ProfessionalVisual Studio 2019 Enterprise

  2. Visual Studio 安装程序提供工作负载列表,即一组用于特定开发领域的相关选项。 对于 Python,请选择 Python 开发工作负载。

    可选:如果使用数据科学,还可考虑使用数据科学和分析应用程序工作负载。 此工作负载包含 Python、R 和 F# 语言支持。 有关详细信息,请参阅数据科学和分析应用程序工作负载

    Visual Studio 安装程序中的 Python 开发工作负载

  3. 在安装程序右侧,如果需要,请选择其他选项。 跳过此步骤,接受默认选项。

    Visual Studio 2022 安装程序中的 Python 开发选项

    Visual Studio 2019 安装程序中的 Python 开发选项

选项 描述
Python 分发版本 选择计划使用的可用选项任意组合,例如 Python 2、Python 3、Miniconda、Anaconda2 和 Anaconda3 分发版本的 32 位和 64 位变体。 每个组合都包含分发版本的解释器、运行时和库。 具体来说,Anaconda 是开放数据科学平台,包含各种预安装的包。 (可随时返回 Visual Studio 安装程序来添加或删除分发版本。)说明:如果已安装 Visual Studio 安装程序之外的分发版本,则无需检查此处的等效选项。 Visual Studio 会自动检测现有的 Python 安装。 请参阅“Python 环境”窗口。 此外,若有比安装程序中所显示的版本更高的 Python 版本可用,可以单独安装较高版本,并且 Visual Studio 会检测到它。
Cookiecutter 模板支持 安装 Cookiecutter 图形用户界面,用于发现模板、输入模板选项以及创建项目和文件。 请参阅使用 Cookiecutter 扩展
Python Web 支持 安装用于 Web 开发的工具(包括 HTML、CSS 和 JavaScript 编辑支持)以及用于使用 Bottle、Flask 和 Django 框架的项目的模板。 请参阅 Python Web 项目模板
Python 本机开发工具 安装 C++ 编译器和其他必要组件用于开发 Python 本机扩展。 请参阅创建适用于 Python 的 C++ 扩展。 若要获取全面的 C++ 支持,还请安装“使用 C++ 的桌面开发”工作负载。

安装后,安装程序会提供用于修改、启动、修复或卸载 Visual Studio 的选项。 当已安装的所有组件均可使用 Visual Studio 更新时,“修改”按钮将更改为“更新” 。 (随后在下拉菜单中提供“修改”选项。)还可搜索“Visual Studio”,从 Windows “开始”菜单启动 Visual Studio 及安装程序。

通过安装程序启动、修改或卸载 Visual Studio (2022)

通过安装程序启动、修改或卸载 Visual Studio (2019)

故障排除

要修复在 Visual Studio 中安装或运行 Python 时出现的问题,请尝试以下步骤:

  • 确定使用 Python CLI(即在命令提示符处运行 python.exe)时是否会出现相同的问题。
  • 使用 Visual Studio 安装程序中的“修复”选项。
  • 在 Windows 中通过“设置”>“应用和功能”修复或重新安装 Python。

示例错误:未能启动交互式进程:System.ComponentModel.Win32Exception (0x80004005):Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext() 处未知错误 (0xc0000135)。

尝试安装或更新 Python 本身时,可能会看到错误,例如 PackageId:CPython39.Exe.x64;PackageAction:DownloadPackage;ReturnCode:0x80070193。 从 https://python.org 下载或安装 Python 失败时,就会出现这些错误。 这可能是由网络超时、企业防火墙策略、VPN 配置、防病毒软件或其他问题造成的。 查看重试是否有帮助,如果没有,请查看是否可以直接从 https://python.org 下载 Python 运行时并手动安装它。

安装位置

默认情况下,为计算机上的所有用户安装 Python 支持。

对于 Visual Studio 2022,Python 工作负载安装在 %ProgramFiles%\Microsoft Visual Studio\<VS_version>\<VS_edition>Common7\IDE\Extensions\Microsoft\Python 中,其中 <VS_version> 为 2022,<VS_edition> 为 Community、Professional 或 Enterprise。

默认情况下,为计算机上的所有用户安装 Python 支持。

对于 Visual Studio 2019 和 Visual Studio 2017,Python 工作负载安装在 %ProgramFiles(x86)%\Microsoft Visual Studio\<VS_version>\<VS_edition>Common7\IDE\Extensions\Microsoft\Python 中,其中 <VS_version> 为 2019 或 2017,<VS_edition> 为 Community、Professional 或 Enterprise。