选择 Python 环境

适用范围：Visual Studio Visual Studio for Mac Visual Studio Code

Python 项目中的所有代码都在特定环境的上下文中运行，例如全局 Python 环境、Anaconda 环境、虚拟环境或 conda 环境。 Visual Studio 还将该环境用于调试、导入和成员完成、语法检查，以及需要特定于 Python 版本和一组已安装包的语言服务的任何其他任务。

Visual Studio 中所有新的 Python 项目最初都被配置为使用默认的全局环境，它出现在“解决方案资源管理器”的“Python 环境”节点下：

要更改项目环境，请右键单击“Python 环境”节点，然后选择“添加环境”。 还可以从 Python 工具栏中的“环境”下拉列表选择“添加环境”。

在“添加环境”对话框中，选择“现有环境”选项卡，然后从“环境”下拉列表中选择新环境：

如果已向项目中添加除全局默认值以外的环境，则可能需要激活新添加的环境。 右键单击“Python 环境”节点下的该环境，然后选择“激活环境”。 若要从项目中删除环境，请选择“删除”。

虚拟环境是特定 Python 解释器和一组特定库的独特组合，它与其他全局环境以及 conda 环境不同。 虚拟环境特定于项目，但保留在项目文件夹中。 该文件夹包含环境中已安装的库，还有一个 pyvenv.cfg 文件用于指定到文件系统中其他位置的环境基础解释器的路径。 （即，虚拟环境中没有解释器副本，只有解释器链接。）

使用虚拟环境的一项优势是，随着项目的开发，虚拟环境始终反映出项目的确切依赖项。 （另一方面，无论是否在项目中使用库，共享的全局环境中都包含任意数量的库。）随后即可通过虚拟环境轻松创建 requirements.txt 文件，此文件之后用于在另一台开发/生产计算机上重新安装上述依赖项。 有关详细信息，请参阅使用 requirements.txt 管理所需的包。

在 Visual Studio 中打开包含 requirements.txt 文件的项目时，Visual Studio 自动显示用于重新创建虚拟环境的选项。 在未安装 Visual Studio 的计算机上，可运行 pip install -r requirements.txt 还原包。

由于虚拟环境包含到基础解释器的硬编码路径，且你可使用 requirements.txt 重新创建环境，因此通常省略来自源代码管理功能集的整个虚拟环境。

下述部分介绍了如何激活项目中的现有虚拟环境以及如何创建新的虚拟环境。

在 Visual Studio 中，可通过“解决方案资源管理器”中的“Python 环境”节点，如其他任意环境一样激活项目的虚拟环境 。

虚拟环境添加到项目后，立即显示在“Python 环境”窗口中。 随后，即可像激活其他任意环境一样激活它，还可管理它的包。

可以按以下方式直接在 Visual Studio 中创建新的虚拟环境：

右键单击“解决方案资源管理器”中的“Python 环境”，然后选择“添加环境”，或从 Python 工具栏上的环境下拉列表中选择“添加环境”。 在出现的“添加环境”对话框中，选择“虚拟环境”选项卡：

为虚拟环境指定一个名称，选择基础解释器，然后验证其位置。 在“从文件安装包”下，提供 requirements.txt 文件的路径（如果需要）。

查看对话框中的其他选项：

选择“创建”以完成虚拟环境。 Visual Studio 会在配置环境和下载任何必要的包时显示一个进度栏。 完成后，虚拟环境将激活并显示在“解决方案资源管理器”的“Python 环境”节点中以及所含项目的“Python 环境”窗口中 。

如果你已经在其他地方创建了虚拟环境，可以按以下方式为项目激活它：

右键单击“解决方案资源管理器”中的“Python 环境”，然后选择“添加环境” 。

在出现的“浏览”对话框中，导航到包含虚拟环境的文件夹并选中，然后选择“确定”。 如果 Visual Studio 在该环境中检测到 requirements.txt 文件，它会询问是否安装这些包。

稍后，虚拟环境会出现在“解决方案资源管理器”中的“Python 环境”节点下。 默认情况下不会激活虚拟环境，因此请右键单击它并选择“激活环境”。

在“解决方案资源管理器”中，右键单击虚拟环境，然后选择“删除”。

Visual Studio 会询问是否移除或删除虚拟环境。 选择“移除”，使其对项目不可用，但在文件系统上保留它。 选择“删除”，从项目中移除环境，并从文件系统中删除它。 基础解释器不受影响。

在“解决方案资源管理器”中，展开特定环境节点以快速查看在该环境中安装的包（也就是说，你可以激活环境时在代码中导入和使用这些包）：

若要安装新包，右键单击该环境并选择“管理 Python 包”（或使用 Python 工具栏上的包按钮）以切换到“Python 环境”窗口中的相应“包”选项卡 。 在“包”选项卡上，输入搜索词（通常为包名称），随后 Visual Studio 将显示匹配的包。

在 Visual Studio 中，已从“Python 包索引 (PyPI)”中下载适用于大多数环境的包（和依赖项），用户可以在其中搜索可用包。 Visual Studio 的状态栏和输出窗口显示有关安装的信息。 若要卸载包，请右键单击它，并选择“删除”。

Conda 包管理器通常将 https://repo.continuum.io/pkgs/ 用作默认通道，但也可以使用其他通道。 有关详细信息，请参阅管理通道 (docs.conda.io)。

请注意，显示的项未必总准确，且安装和卸载可能不可靠或不可用。 Visual Studio 使用 pip 程序包管理器（如果可用），并且需要时会下载并安装它。 Visual Studio 还可以使用 easy_install 程序包管理器。 也会显示使用 pip 或 easy_install 从命令行安装的包。

另请注意，Visual Studio 目前不支持使用 conda 将包安装到 conda 环境中。 而是使用命令行中的 conda。

提示

当包中包含用于 *.pyd 文件中本机组件的源代码时，pip 无法安装包，这种情况很常见。 如果没有安装要求的 Visual Studio 版本，pip 无法编译这些组件。 在此情况下显示的错误消息是：“错误：找不到 vcvarsall.bat”。 easy_install 通常可下载预编译的二进制文件，且你可通过 https://python.en.uptodown.com/windows/versions 下载适合旧版 Python 的编译器。 有关详细信息，请参阅 Python 工具团队博客上的How to deal with the pain of "unable to find vcvarsallbat"（如何处理“找不到 vcvarsallbat”问题）。