安装 Python 解释器

有多种选项可用于安装 Python 解释器以使用 Visual Studio。 可以在安装 Python 工作负荷时安装解释器,也可以在工作负荷存在后安装解释器。 解释器也可以在 Visual Studio 安装程序外部手动安装。

默认情况下,在 Visual Studio 2017 和更高版本中安装 Python 开发工作负荷也会同时安装 Python 3(64 位)。 你可以根据需要选择安装 32 位或 64 位版本的 Python 2 或 Python 3,并安装 Miniconda (Visual Studio 2019) 或者 Anaconda 2/Anaconda 3 (Visual Studio 2017)。 此类型安装的步骤在在 Visual Studio 中安装 Python 支持中进行了介绍。

另一种方法是使用 Visual Studio 中的“添加环境”功能安装标准 Python 解释器。 此选项在 Python 环境窗口和 Python 工具栏中可用。

Python 解释器也可以在 Visual Studio 安装程序外部手动安装。 假设在安装 Visual Studio 之前安装 Anaconda 3。 无需通过 Visual Studio 安装程序重新安装 Anaconda。 你也可以安装 Visual Studio 安装程序中尚未列出的较新版本的解释器。

先决条件

  • Visual Studio 支持 Python 3.7 版本。 虽然可以使用早期版本的 Visual Studio 来编辑在早期版本的 Python 中编写的代码,但这些版本的 Python 不受官方支持。 Visual Studio 功能(如 IntelliSense 和调试)可能不适用于早期版本的 Python。

  • 对于 Visual Studio 2015 及更早版本,请使用 Python 3.5 或更早版本。 必须手动安装其中一个 Python 解释器。

Anaconda 发行版

尽管 Visual Studio 提供了安装 Anaconda 分发版的服务,但你对 Anaconda 存储库中发行版和其他包的使用都受 Anaconda 服务条款的约束。 这些条款可能要求一些组织向 Anaconda 支付商业许可证,否则就需要配置工具来访问备用存储库。 有关详细信息,请参阅 Conda 通道文档

查看 Python 解释器

下表列出了可用于 Visual Studio 的 Python 解释器。

解释器 说明 说明
CPython 最常用的“本机”解释器,32 位和 64 位版本可用(建议使用 32 位)。 包括最新的语言功能、最大的 Python 包兼容性、完整的调试支持以及与 IPython 的互操作。 查看“应使用 Python 2 还是 Python 3?”中的注意事项,以帮助确定要安装的 Python 版本。 Visual Studio 2015 及更早版本不支持 Python 3.6 或更高版本,并且会返回“不支持 Python 版本 3.6”之类的错误。 对于 Visual Studio 2015 及更早版本,请使用 Python 3.5 或更早版本。
IronPython Python 的 .NET 实现,可在 32 位和 64 位版本中使用。 提供 C#/F#/Visual Basic 互操作、对 .NET API 的访问、标准 Python 调试(但不是 C++ 混合模式调试)和混合 IronPython/C# 调试。 IronPython 不支持虚拟环境。
Anaconda 由 Python 提供支持的开放数据科学平台。 包括最新版本的 CPython 和大多数难以安装的软件包。 如果无法确定解释器,建议使用 Anaconda。
PyPy Python 的高性能跟踪 JIT 实现。 适用于长时间运行的程序以及确定性能问题但找不到其他解决方法的情况。 可与 Visual Studio 配合使用,但对高级调试功能的支持有限。
Jython Java 虚拟机 (JVM) 上 Python 的实现。 与 IronPython 类似,Jython 中运行的代码可与 Java 类和库交互。 但是,许多适用于 CPython 的库可能无法访问。 可与 Visual Studio 配合使用,但对高级调试功能的支持有限。

检测你的环境

Visual Studio 会在“Python 环境”窗口中显示所有已知环境。 它会自动检测对现有解释器的更新。

如果 Visual Studio 并未检测到安装的环境,请参阅手动标识现有环境

如果你想提供新形式的 Python 环境检测的开发人员,请参阅 PTVS 环境检测 (github.com)。

注册表项

Visual Studio(所有版本)通过检查注册表(根据 PEP 514 - Windows 注册表中的 Python 注册)自动检测各个已安装的 Python 解释器及其环境。 Python 安装通常位于 HKEY_LOCAL_MACHINE\SOFTWARE\Python(32 位)和 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python(64 位)项下的“PythonCore”(CPython) 和“ContinuumAnalytics”(Anaconda) 等分发节点中

移动解释器

如果将现有解释器移到使用文件系统的新位置,则 Visual Studio 不会自动检测更改。

  • 如果最初通过“Python 环境”窗口指定解释器的位置,则可以使用该窗口中的“配置”选项卡来编辑其环境,以确定新位置。 有关详细信息,请参阅手动标识现有环境

  • 如果使用安装程序安装解释器,则使用以下步骤在新位置重新安装解释器:

    1. 将 Python 解释器还原到其原始位置。
    2. 使用其安装程序卸载解释器,这会清除注册表项。
    3. 在新位置重新安装解释器。
    4. 重启 Visual Studio,它应该会自动检测新位置来代替原来的位置。

此过程可确保标识解释器位置的注册表项正确更新,以供 Visual Studio 使用。 使用安装程序还可以处理可能存在的任何其他副作用。