摘要

本PEP建议像pip这样的包安装程序在Python 3.13及更高版本上默认要求使用虚拟环境。

PEP撤回

在讨论本PEP期间，很明显pip的用户体验更改不受PEP提议的控制。同时也很清楚，大量用户依赖于能够将pip管理的依赖项与其他工具管理的依赖项混合使用（最主要的是使用Conda时）。

此外，提议更改的许多好处可以通过PEP 668（在撰写本文时已被接受并实现）来实现。它为Python解释器的重新分发者提供了控制权，以决定是否要求用户使用虚拟环境，向用户显示的消息以及如何为其用户推出此更改。

由于使用pip强制执行虚拟环境是本PEP的主要重点，因此撤回本PEP比将其重新聚焦于其他主题更合适。

将来仍然可以创建一个PEP来解决虚拟环境命名约定问题，但最好将任何此类工作作为一个新的PEP开始，该PEP侧重于此类约定的好处，而不是强制执行。

动机

Python虚拟环境是Python开发工作流程中必不可少的一部分。但是，它们需要额外的努力，因为它们是可选功能，并且要求用户：

• 采取明确的步骤激活/停用虚拟环境
• 使用<path-to-venv>/<bin-path>/<executable>运行文件

对于新用户来说，当不使用虚拟环境时，事情似乎会正常工作——直到它们不正常工作为止。此外，在不同平台上激活虚拟环境使用略微不同的语法和机制。这使得虚拟环境的介绍变得复杂，因为现在需要向用户解释有关它们如何/为何有用的信息和上下文，以证明在工作流程中添加额外步骤是合理的。

它也为错误创造了空间，因为用户需要记住在运行像pip这样的安装程序之前激活虚拟环境或配置这些安装程序以出错。在某些Linux发行版上，忘记这样做会导致安装程序修改操作系统拥有的文件（这部分由PEP 668缓解，适用于选择相应标记其环境的发行版）。

基本原理

更改像pip这样的安装程序的默认行为以要求激活虚拟环境将：

• 使新用户更容易开始使用Python（因为存在一致的体验，并且虚拟环境被理解为必须使用的东西）
• 默认情况下减少所有用户意外安装问题的范围（通过明确标记何时未使用虚拟环境）。

建立将虚拟环境放置在树内名为.venv的目录中的约定，消除了常见工作流程的决策点，并在生态系统中创建了一个清晰的约定。

规范

向后兼容性

此PEP与用户在虚拟环境外部使用安装程序的工作流程不兼容。此类用户将收到错误消息提示，并且需要：

• 明确选择在虚拟环境外部运行安装程序，或
• 创建并使用虚拟环境

已经使用虚拟环境的用户不会受到此更改的影响。

工作流程工具（在后台为用户管理虚拟环境）应该不受影响，因为它们应该已经在使用虚拟环境来运行安装程序。

安全影响

此PEP没有引入任何新的安全影响。

如何教授

此PEP要求新用户创建并使用虚拟环境来开始使用Python包。但是，这是一种最佳实践，正如Python打包用户指南中“如何安装Python包的基础知识”部分所演示的那样，该部分在讨论使用pip之前解释了虚拟环境是什么以及如何使用。

参考实现

此PEP没有参考实现。但是，提议的行为在很大程度上已在pip中实现，可以通过将PIP_REQUIRE_VENV环境变量设置为1来激活。（将其保留为空会导致提议的可选行为，即在安装时不需要虚拟环境。）

实现说明

def is_virtual_environment():
    return sys.base_prefix != sys.prefix or hasattr(sys, "real_prefix")

被拒绝的想法

未解决的问题

无。

版权

本文档置于公共领域或根据CC0-1.0-Universal许可证，以两者中更宽松者为准。