Ubuntu 下 Python 兼容性问题是个常见坑,核心原因大多是 系统自带 Python 被动、多版本并存冲突、pip 装包权限/路径不对。下面按常见场景给你一套实用排查与解决思路。
不要动系统自带的 Python(尤其是 python3)
Ubuntu 很多系统工具(apt、software-properties 等)依赖它。
❌ 错误示例:
sudo rm /usr/bin/python3
sudo apt remove python3
这会导致系统直接崩。
ls /usr/bin/python*
python3 --version
which python3
sudo apt update
sudo apt install python3.10
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 2
# 切换
sudo update-alternatives --config python3
⚠️ 如果你只是自己写代码用,更推荐下面这种。
python3 -m venv venv
source venv/bin/activate
pip install xxx
退出:
deactivate
✅ 优点:
报错类似:
error: externally-managed-environment
✅ 正确做法:
python3 -m venv venv
source venv/bin/activate
pip install xxx
❌ 不要随便用:
sudo pip install xxx
检查:
which python
which pip
建议统一用:
python -m pip install xxx
| Ubuntu | 自带 Python | 建议 |
|---|---|---|
| 20.04 | 3.8 | 用 venv |
| 22.04 | 3.10 | 用 venv |
| 24.04 | 3.12 | 必须 venv |
你可以直接把 报错信息贴出来,比如:
我可以按你的 Ubuntu 版本 + Python 版本精准帮你解决。
你现在是哪种情况?