现象
在 Ubuntu 24.04 的 Python 3.12 上执行 pip install requests,终端提示 SuCcessfully installed requests,可脚本一运行就报 ModuleNotFoundError: No module named 'requests'。直接 python -c 测试同样报错,重装和升级 pip 都没变化。
原因
包确实装上了,只是装进了另一个解释器的 site-packages。机器上同时存在系统 Python、venv 和 pyenv 多个版本,pip 与 python 两个命令指向的并不是同一个。另一种情况是用 sudo 或 --user 安装,包落在 root 或当前用户目录里,而脚本以别的身份运行,sys.path 里没有那条路径。
解决步骤
第一步,对比两个命令的真实路径。打印解释器位置和 pip 归属,多数问题这一步就能看出来。
python -c "import sys; print(sys.executable)"
python -m pip -V
which -a python python3 pip pip3
第二步,统一用 python -m pip 安装。这样能保证 pip 和解释器同源;虚拟环境里先激活再装,不要加 sudo。若之前用 --user 装错,先卸载再装到当前环境里。
第三步,检查 sys.path 和同名文件。打印 sys.path 看报错目录是否在其中,检查 PYTHONPATH 有没有把别的环境顶到前面;再确认工作目录里没有同名文件,自己写个 json.py 会遮蔽标准库。
验证
用同一个解释器执行 python -c "import requests; print(requests.__version__)",能打印出版本号,再对比 pip show requests 里的 Location 与 sys.path 中的目录,一致就说明两者已是同一个环境。
小结
这类报错多半不是没装,而是装错了解释器。把 python -m pip 当成默认写法,比记住 pip 到底指向哪里更可靠。
