Python包依赖版本冲突求助：click与flask、fuji版本不兼容

问题分析 #

当前存在两处核心版本冲突：

• Flask 1.1.4 要求 click 版本范围为 >=5.1, <8.0，但环境中安装了 click 8.1.3，二者不兼容
• 包 fuji 要求 click>=8.0.3，但环境中同时存在 click 7.1.2，触发版本冲突

解决方案 #

方案1：用虚拟环境隔离依赖（推荐） #

虚拟环境能为不同项目维护独立依赖环境，彻底避免全局依赖冲突：

1. 创建并激活虚拟环境：

   # Python 3.7 环境下创建虚拟环境
   python3.7 -m venv my-project-env
   # macOS/Linux 激活环境
   source my-project-env/bin/activate
   # Windows 激活环境
   my-project-env\Scripts\activate
   

2. 在激活的虚拟环境中选择适配的依赖组合安装：
   • 优先保留 Flask 1.1.4：安装兼容的 click 版本，再查找并安装支持该 click 版本的 fuji 版本

     pip install flask==1.1.4 click~=7.1.2
     # 替换为实际兼容的fuji版本号
     pip install fuji==x.x.x
     

   • 优先保留 fuji：升级 Flask 到支持 click>=8.0.3 的版本

     pip install fuji
     # 安装与click>=8.0.3兼容的Flask版本
     pip install flask>=2.0.0
     

方案2：调整全局依赖版本（不推荐，易影响其他项目） #

若必须使用全局环境，可手动指定兼容版本组合：

1. 卸载冲突的 click 版本：

   pip uninstall -y click
   

2. 二选一安装适配组合：
   • 适配 Flask 1.1.4：

     pip install click==7.1.2 flask==1.1.4
     pip install fuji==x.x.x  # 替换为兼容click7.1.2的fuji版本
     

   • 适配 fuji：

     pip install click>=8.0.3 fuji
     pip install flask>=2.0.0
     

方案3：用pip-tools锁定兼容依赖版本 #

pip-tools可自动生成无冲突的精确依赖列表：

1. 安装pip-tools：

   pip install pip-tools
   

2. 创建requirements.in文件，写入所需包：

   flask==1.1.4
   fuji
   

3. 编译生成兼容依赖列表：

   pip-compile requirements.in
   

   若编译失败，说明Flask 1.1.4和fuji无共同兼容的click版本，此时必须升级其中一个包（如Flask到2.x版本）。

内容的提问来源于stack exchange，提问作者Gurudev Kumar