Python 包版本冲突通常表现为 ImportError、AttributeError 或运行时报错提示“某函数不存在”“某参数不支持”，本质是不同包依赖了同一第三方库的不同版本，而 pip 只能安装一个版本——后安装的会覆盖前一个，导致先装的包出问题。

用虚拟环境隔离依赖

最根本、最推荐的做法：每个项目单独配一个虚拟环境，避免全局包互相干扰。

• 创建环境：python -m venv myproject_env
• 激活环境（Windows）：myproject_env\Scripts\activate；（macOS/Linux）：source myproject_env/bin/activate
• 在激活状态下用 pip install 安装所需包，所有依赖只存在于该环境内

查看和分析依赖树

搞清谁在依赖哪个版本，才能精准定位冲突源头。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• 安装 pipdeptree：pip install pipdeptree
• 运行 pipdeptree 查看完整依赖关系；加 --reverse 可查某个包被谁依赖，例如：pipdeptree --reverse --package requests
• 重点关注带 [conflict] 标记的行，说明有多个包要求不同版本

手动指定兼容版本或降级/升级

确认冲突后，可尝试找一个所有依赖都能接受的中间版本。

立即学习“Python免费学习笔记（深入）”；

• 先卸载冲突包：pip uninstall package_name
• 再安装指定版本：pip install package_name==2.28.2（以 requests 为例）
• 如果不确定哪个版本兼容，可逐个尝试常见稳定版（如 2.25.x、2.28.x），或参考各包的 setup.py 或 pyproject.toml 中的 requires 字段

用 pip-tools 精确锁定依赖

适合中大型项目，把依赖声明和实际安装解耦，避免“本地能跑、服务器报错”。

• 写 requirements.in，只列直接依赖（如 requests、django）
• 运行 pip-compile requirements.in 生成带精确版本和依赖树的 requirements.txt
• 部署时用 pip install -r requirements.txt，确保环境一致