python 包版本冲突通常表现为 ImportError、AttributeError 或运行时报错提示“某函数不存在”“某参数不支持”，本质是不同包依赖了同一第三方库的不同版本，而 pip 只能安装一个版本——后安装的会覆盖前一个，导致先装的包出问题。
用虚拟环境隔离依赖
最根本、最推荐的做法：每个项目单独配一个虚拟环境，避免全局包互相干扰。
- 创建环境：
python -m venv myproject_env - 激活环境（windows）：
myproject_envScriptsactivate；（macos/linux）：source myproject_env/bin/activate - 在激活状态下用
pip install安装所需包，所有依赖只存在于该环境内
查看和分析依赖树
搞清谁在依赖哪个版本，才能精准定位冲突源头。
- 安装
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，确保环境一致