嘿，我之前也碰到过一模一样的糟心事！明明装了模块，导入时却报错，路径也配了还是没用。咱们一步步排查，大概率能搞定：

• 确认Python解释器与pip的匹配性
  很多时候问题出在多个Python版本共存上。先在终端里跑这两个命令：

  # Linux/macOS
  which python
  pip --version
  # Windows
  where python
  pip --version
  

  看看pip --version输出里的Python路径，和当前用的python路径是不是一致。如果不一致，说明你用的pip对应另一个Python版本，这时候要改用对应版本的pip（比如pip3），或者直接用解释器调用pip：python3 -m pip install [模块名]，确保模块装到当前用的Python环境里。

• 检查Python的模块搜索路径
  打开Python交互环境，运行：

  import sys
  print(sys.path)
  

  这会输出Python查找模块的所有路径。你可以先找一个已安装模块的位置，比如跑pip show requests（把requests换成你装的模块），看输出里的Location字段，对比这个路径有没有出现在sys.path里。如果没在，要么是你配置PYTHONPATH时写错了路径，要么是环境变量没生效（记得重启终端或者重新加载环境变量）。

• 排查虚拟环境是否激活
  如果你用了虚拟环境（比如venv），一定要确认是否激活了它。没激活的话，当前终端用的是全局Python，自然找不到虚拟环境里装的模块：

  # Linux/macOS激活虚拟环境
  source venv/bin/activate
  # Windows激活虚拟环境
  venv\Scripts\activate
  

  激活后终端提示符会显示虚拟环境名称，这时候再装模块或者运行代码就没问题了。

• 检查用户目录下的模块安装
  有时候没有用管理员权限装模块（Linux/macOS没加sudo），pip会把模块装到用户专属的site-packages目录。这时候可以运行pip install --user [模块名]来确保模块装到当前用户能访问的路径，或者检查sys.path里有没有包含用户目录的site-packages（一般是~/.local/lib/pythonX.X/site-packages这种格式）。

• 终极方案：重装pip或Python
  如果以上方法都试过还是不行，可能是pip或者Python本身出现了损坏。可以先升级pip：

  python -m ensurepip --upgrade
  

  如果还是没用，干脆重装Python，记得安装时勾选“Add Python to PATH”（Windows），或者安装后手动把Python路径加到环境变量里。

内容的提问来源于stack exchange，提问作者ChickenMeister