复制Python虚拟环境时遭遇pip ResolutionError问题求助

我尝试在本地复制一个Python虚拟环境：先在现有虚拟环境中执行pip freeze > requirements.txt，停用后创建并激活了Python版本完全相同（3.8.10）的全新虚拟环境，随后执行pip install -r requirements.txt安装依赖时出现以下错误：

ERROR: Cannot install -r requirements.txt (line 31), -r requirements.txt (line 40), -r requirements.txt (line 48) and Jinja2==2.11.3 because these package versions have conflicting dependencies.

The conflict is caused by:
    The user requested Jinja2==2.11.3
    cookiecutter 2.1.1 depends on Jinja2<4.0.0 and >=2.7
    distributed 2022.8.0 depends on jinja2
    flask 2.2.2 depends on Jinja2>=3.0

To fix this you could try to:
1. loosen the range of package versions you've specified
2. remove package versions to allow pip attempt to solve the dependency conflict

ERROR: ResolutionImpossible: for help visit https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts

我对此感到困惑：这些包在原虚拟环境中可共存，说明依赖原本是可解析的。我尝试移除requirements.txt中的Jinja2条目，但又出现其他包的报错。请问该现象原因是什么？如何解决？

原因分析 #

• pip freeze的局限性：pip freeze只会导出环境中所有包的精确版本（包括间接依赖），但不会记录安装顺序和当时的依赖约束逻辑。原环境中可能是先安装了Jinja2==2.11.3，后续安装flask 2.2.2时，因旧版pip的宽松解析或当时依赖约束未更新，没有触发冲突；而新环境中pip用严格的当前约束校验，直接检测到冲突。
• pip版本差异：原环境和新环境的pip版本可能不同。旧版pip依赖解析逻辑宽松，允许潜在冲突存在；新版pip（20.3+）启用了新解析器，会严格检查所有依赖兼容性，发现冲突就终止安装。
• 间接依赖约束更新：原环境安装后，部分包的间接依赖约束可能已更新，但pip freeze导出的是固定旧版本，新环境安装时，这些包的最新约束和旧版本产生冲突。

解决方法 #

方法一：匹配原环境的pip版本 #

先在新环境安装和原环境完全相同的pip版本：

pip install pip==<原环境pip版本号>

再执行pip install -r requirements.txt，旧版pip的解析逻辑会和原环境一致，大概率能跳过冲突完成安装。

方法二：用pip-tools生成兼容的依赖文件 #

1. 安装pip-tools：

pip install pip-tools

2. 创建requirements.in文件，只写入你主动安装的直接依赖包（比如flask、cookiecutter、distributed，不要写Jinja2这类间接依赖）。
3. 执行命令生成兼容的requirements.txt：

pip-compile requirements.in

最后用生成的文件执行安装即可。

方法三：手动调整冲突包版本 #

根据报错信息，flask 2.2.2要求Jinja2>=3.0，而你指定了Jinja2==2.11.3，二选一调整：

• 把flask降级到兼容Jinja2 2.11.3的版本（比如flask 1.x系列）；
• 把Jinja2升级到>=3.0的兼容版本（比如Jinja2==3.0.3），同时确认cookiecutter、distributed也支持该版本。
  调整后更新requirements.txt的对应版本，再尝试安装。

方法四：跳过依赖校验安装（需测试验证） #

先安装所有包但不安装它们的依赖：

pip install --no-deps -r requirements.txt

再执行pip install -r requirements.txt让pip自动补充缺失依赖。这种方法会忽略冲突，但可能存在潜在兼容性问题，安装后务必测试功能是否正常。

内容的提问来源于stack exchange，提问作者Ben Jeffrey