pip安装Python包后导入报No module named、PyCharm识别不到包问题

这是多Python环境共存时，pip安装路径与运行代码所用解释器路径不匹配导致的典型问题，不存在包损坏之类的特殊情况，按以下步骤操作即可解决。

终端环境修复 #

• 先定位当前终端默认调用的Python解释器绝对路径：
  • macOS/Linux执行：which python3
  • Windows执行：where python
• 不要直接使用裸pip/pip3命令安装，强制绑定刚才查到的解释器执行安装，从根源避免装错环境：

  # 将<解释器绝对路径>替换为上一步输出的路径，<包名>替换为你要安装的第三方包名
  <解释器绝对路径> -m pip install <包名>
  

• 验证安装结果：执行<解释器绝对路径>进入Python交互模式，输入import <包名>，此时不会再出现No module named报错。

PyCharm环境对齐 #

• 打开PyCharm设置，进入Project: <你的项目名> > Python Interpreter配置页
• 检查右上角选中的解释器路径，必须和上一步终端里验证能正常导包的解释器路径完全一致：
  • 若路径不匹配，点击配置页齿轮图标，选择Add Existing Interpreter，导入上述正常可用的解释器并选中
  • 若路径已经匹配，直接点击包列表旁的+号，搜索目标包执行安装，安装完成后PyCharm会立刻识别到包，不会再显示未安装状态。

不要使用sudo pip直接给系统自带Python装包，容易破坏系统依赖；使用conda、venv等虚拟环境时，必须先激活对应环境再执行安装操作，激活后终端行首会显示虚拟环境名称，此时安装的包只会存在于当前虚拟环境内，不会和全局环境混淆。

内容的提问来源于stack exchange，提问作者Sultan Al-otaibi