Python本地通过pip安装模块后Spyder无法导入问题求助

• 解释器环境不匹配（最高发问题）
  本地执行pip命令的Python环境，和Spyder绑定的Python解释器不属于同一个环境，例如pip用的是系统全局Python，而Spyder用的是conda虚拟环境、独立安装的Python环境。
  排查方法：
  在Spyder的IPython控制台执行以下代码，查看当前使用的解释器路径：

  import sys
  print(sys.executable)
  

  再在你执行pip安装命令的终端执行对应命令查看pip所属的Python路径：

  # macOS/Linux 执行
  which pip
  # Windows cmd 执行
  where pip
  

  如果两者路径不匹配，直接用Spyder对应解释器的绝对路径执行安装即可，示例：

  # 把下面的路径替换为你上一步查到的Spyder解释器路径
  C:\ProgramData\Anaconda3\python.exe -m pip install 要安装的包名
  

• 包的安装名称与导入名称不一致
  部分第三方包的安装命令用的名称和实际导入时用的名称不同，例如安装时执行pip install opencv-python，导入时需要写import cv2；安装pip install pyyaml，导入时是import yaml。
  你可以执行pip list确认包已经安装成功后，查询对应包的官方文档，确认正确的导入语法。
• Spyder未刷新环境缓存
  如果你是在Spyder已经启动运行的状态下安装的新包，需要重启Spyder让解释器重新加载已安装包的索引，即可识别新安装的模块。
• 权限导致的安装路径不匹配
  如果你用普通用户权限执行pip安装，包会被安装到当前用户的专属site-packages目录，如果Spyder是用管理员/其他用户身份启动，就会无法读取该路径下的包。可以统一Spyder的启动身份与执行pip命令的用户身份，或在安装包时授予对应全局权限。

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