Ubuntu 上 Python 报错的原因非常多,不能一概而论。下面我按最常见场景给你一个排查清单,你可以对照看看;如果你愿意,把具体报错信息贴出来,我可以精准定位。
| 场景 | 典型报错 | 原因 |
|---|---|---|
| 1️⃣ 命令找不到 | python: command not found |
Ubuntu 默认只有 python3 |
| 2️⃣ 版本混乱 | ModuleNotFoundError |
用错 Python / pip |
| 3️⃣ pip 装不上 | externally-managed-environment |
Ubuntu 限制了系统 Python |
| 4️⃣ 权限错误 | Permission denied |
没用虚拟环境 |
| 5️⃣ 依赖缺失 | ImportError: libxxx.so |
缺少系统库 |
| 6️⃣ 脚本执行 | bad interpreter |
shebang 错误或 Windows 换行符 |
python 命令python
❌ 报错:command not found
✅ 正确用法:
python3
或手动建立软链接(不推荐破坏系统):
sudo apt install python-is-python3
pip install requests
python3 test.py
❌ 可能装到了 python2 或系统 pip
✅ 正确方式:
python3 -m pip install requests
报错示例:
error: externally-managed-environment
✅ 正确做法(强烈推荐):
python3 -m venv venv
source venv/bin/activate
pip install xxx
❌ 错误:
sudo pip install xxx
✅ 正确:
pip install --user xxx
或 使用虚拟环境
常见报错:
ImportError: libssl.so.1.1
解决:
sudo apt install libssl-dev
sudo apt install python3-dev
python3 --version
python3 -m pip --version
which python3
请贴出 完整报错信息(不是只说“报错了”):
1️⃣ 你执行的命令
2️⃣ 完整报错内容
3️⃣ Ubuntu 版本:
lsb_release -a
Ubuntu 上 Python 报错,90% 是:版本不对 / pip 用错 / 没用虚拟环境。
你可以直接把报错贴出来,我帮你逐行解释 ✅