温馨提示×

Ubuntu Python为何报错

小樊
45
2026-08-24 17:59:13
栏目: 编程语言

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 换行符

二、Ubuntu 特有坑(重点)

✅ 1. Ubuntu 没有 python 命令

python

❌ 报错:command not found

✅ 正确用法:

python3

或手动建立软链接(不推荐破坏系统):

sudo apt install python-is-python3

✅ 2. pip 和 Python 不对应(90% 新手问题)

pip install requests
python3 test.py

❌ 可能装到了 python2 或系统 pip

✅ 正确方式:

python3 -m pip install requests

✅ 3. Ubuntu 22.04+ 禁止直接 pip 装系统 Python

报错示例:

error: externally-managed-environment

✅ 正确做法(强烈推荐):

python3 -m venv venv
source venv/bin/activate
pip install xxx

✅ 4. 权限问题

❌ 错误:

sudo pip install xxx

✅ 正确:

pip install --user xxx

使用虚拟环境


✅ 5. 缺少系统依赖

常见报错:

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 用错 / 没用虚拟环境。

你可以直接把报错贴出来,我帮你逐行解释 ✅

0