ubuntu python错怎排查

在 Ubuntu 上排查 Python 报错，可以按下面从快到细的步骤来：

一、先看清错误本身

1. 完整复制报错信息（不要只截图一部分）
2. 看最后几行，通常格式是：

   Traceback (most recent call last):
     File "xxx.py", line N, in <module>
       ...
   ErrorType: 具体原因
   

3. 常见错误类型：
   • ModuleNotFoundError → 包没装或环境不对
   • PermissionError → 权限不足
   • SyntaxError → 代码语法问题
   • Python version 不兼容

二、确认 Python 环境（非常关键）

Ubuntu 常有多版本 Python：

which python
which python3
python3 --version

运行脚本建议明确用：

python3 your_script.py

查看当前用的 pip：

python3 -m pip --version

✅ 推荐永远用：

python3 -m pip install xxx

而不是 pip install xxx

三、虚拟环境排查（强烈建议）

很多“明明装了却找不到”的问题来自环境错乱。

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

激活后命令行前面会出现 (venv)

四、常见具体问题速查

1️⃣ ModuleNotFoundError

python3 -m pip install 包名

还不行？

pip list | grep 包名

2️⃣ pip 报 SSL / 网络错误

sudo apt update
sudo apt install python3-pip

或使用国内源：

pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple

3️⃣ Permission denied

不要用 sudo pip（会破坏系统） 用虚拟环境，或：

pip install --user 包名

4️⃣ Ubuntu 自带 Python 被你改坏

不要删 /usr/bin/python3 修复：

sudo apt install --reinstall python3

五、调试技巧

打印调试

print(type(x), x)

进入交互调试

python3 -i your_script.py

用 logging 而不是 print

import logging
logging.basicConfig(level=logging.DEBUG)

六、把错误发出来我能直接帮你

你可以贴：

1. 完整报错
2. python3 --version
3. 是否用虚拟环境
4. Ubuntu 版本（lsb_release -a）

我可以直接告诉你是哪一步错了、怎么改。