ubuntu python为何无法导入

ubuntu

小樊

2026-09-04 13:54:35

栏目: 编程语言

在 Ubuntu 上 Python 无法导入模块，通常不是 Python 本身坏了，而是环境或路径问题。下面按最常见原因给你排查清单，你可以对照看。

一、最常见原因汇总

1️⃣ 用错了 Python 版本

Ubuntu 常同时有：

python3（系统默认）
python（可能是 Python 2）

which python
which python3
python --version
python3 --version

如果你这样装：

pip install xxx

但运行：

python3 script.py

就可能找不到模块

✅ 正确做法：

python3 -m pip install xxx
python3 script.py

2️⃣ pip 和 python 不是同一个

检查：

python3 -m pip --version
pip3 --version

建议永远用：

python3 -m pip install 包名

3️⃣ 虚拟环境没激活

如果你用 venv：

python3 -m venv venv
source venv/bin/activate

❌ 没激活就 import → 报错 ModuleNotFoundError

4️⃣ 模块根本没装

python3 -c "import 包名"

如果报错：

ModuleNotFoundError: No module named 'xxx'

那就：

python3 -m pip install xxx

5️⃣ 当前目录问题（相对导入）

例如：

project/
 ├── main.py
 └── utils.py

main.py 里：

import utils   # ✅
from project.utils import xxx  # ❌

⚠️ 在 Ubuntu 下运行方式很重要：

python3 main.py   # ✅
python3 project/main.py  # ❌

6️⃣ 权限问题（系统 Python）

不要改系统 Python：

sudo pip install xxx  # ❌ 危险

✅ 推荐：

python3 -m pip install --user xxx

或虚拟环境。

7️⃣ PYTHONPATH 没设置

如果你自己写了模块：

export PYTHONPATH=$PYTHONPATH:/你的路径

二、快速自检命令（复制用）

python3 -c "import sys; print(sys.path)"
python3 -m pip list | grep 包名
which python3

三、你可以这样告诉我，我能精准帮你

把下面信息发我：

错误信息（完整）
用的命令（python / python3 / pip）
是否用 venv
Ubuntu 版本

例如：

Ubuntu 22.04，python3 main.py 报错 ModuleNotFoundError: numpy

我可以直接告诉你该用哪条命令。