python包加载失败主因是解释器路径与pip安装路径不一致。需确认python和pip指向同一环境，检查sys.path与site-packages实际路径是否匹配，并排查.pth文件、用户站点及ide解释器配置干扰。
Python第三方包加载失败，多数情况是包路径没对上。核心就两点：Python解释器找包时用的sys.path，和你实际安装包的位置是否一致。
检查当前Python环境和pip是否匹配
经常出问题的是：你在终端用pip install requests装了包，但运行脚本时用的是另一个Python解释器（比如VS Code默认用了虚拟环境，而pip装在系统Python里）。先确认：
- 运行
which python（macos/linux）或where python（windows），看脚本用的是哪个Python - 运行
which pip或where pip，看pip对应的是不是同一个Python - 更稳妥：直接在Python里查
import sys; print(sys.executable)和!pip --version（jupyter中）或python -m pip --version
验证包是否真装在当前环境里
别只信“pip install成功”，要亲自查：
- 运行
python -m pip list | grep 包名（Linux/macOS）或用findstr（Windows） - 进Python后执行：
import sys; [p for p in sys.path if 'site-packages' in p]，看输出的路径里有没有这个包的文件夹 - 手动去那个
site-packages目录下翻一翻，比如ls xxx/site-packages/requests/，确认__init__.py存在
留意.pth文件和用户站点（user-site）干扰
有些包（尤其用--user安装或某些打包工具）会把路径写进.pth文件，或启用用户站点目录。这容易导致sys.path里多出意料之外的路径：
立即学习“Python免费学习笔记（深入）”；
- 运行
python -m site，看输出里的USER_SITE和ENABLE_USER_SITE - 检查
sys.path开头几个路径是否包含site-packages以外的自定义目录 - 临时禁用用户站点：启动Python时加
-s参数（python -s script.py）
IDE或编辑器自带Python解释器路径陷阱
VS Code、pycharm、Jupyter常默认使用自己的解释器或虚拟环境，但终端里pip可能指向别的地方：
- VS Code：按
Ctrl+Shift+P→ “Python: select Interpreter”，确认选中的是你期望的环境 - PyCharm：File → Settings → Project → Python Interpreter，看右上角路径是否和
which python一致 - Jupyter：在notebook里运行
!which python和import sys; sys.executable对比
路径问题本质是“谁在找、在哪找、找什么”。理清解释器、pip、site-packages三者关系，再逐层验证，90%的加载失败都能快速定位。