PyCharm配置venv中Jupyter无法导入multipledispatch问题

出现该现象的核心原因是Notebook实际运行代码的解释器，和你在单元格中用!前缀调用shell执行命令时用的解释器不是同一个：

• 单元格中带!前缀的shell命令会继承Jupyter启动时的系统PATH变量，默认调用PATH优先级最高的Python解释器，不会自动绑定当前Notebook Kernel使用的解释器。你执行!python -m pip list看到的multipledispatch、执行!python -m pip install提示的依赖已满足，都是针对shell找到的这个Python环境的，不是Kernel真正跑代码的环境。
• 其他第三方包可以正常导入，是因为这些包在两个解释器环境中都存在，只有multipledispatch仅安装在你终端激活的venv环境、以及shell调用的Python环境中，没有安装到Kernel实际使用的解释器环境里，才会出现单独这个包导入失败的情况。
• 低概率场景是multipledispatch安装过程中出现文件损坏、dist-info元数据残留，pip能识别到安装记录，但实际包文件不在Python模块搜索路径中。

按顺序操作即可：

1. 先确认Kernel实际使用的解释器绝对路径，在Notebook单元格中运行以下代码（不要加!前缀）：

   import sys
   print(sys.executable)
   

   复制输出的完整路径，这就是当前Notebook运行代码真正调用的Python程序。
2. 用拿到的解释器路径强制重装multipledispatch，把命令里的路径占位符替换成你实际复制的内容，在单元格中执行：

   <替换为上一步输出的Python路径> -m pip install --force-reinstall multipledispatch
   

   举个Windows环境的例子，如果第一步输出路径是D:\workspace\demo\venv\Scripts\python.exe，实际执行的命令就是：

   D:\workspace\demo\venv\Scripts\python.exe -m pip install --force-reinstall multipledispatch
   

   Mac/Linux环境如果输出是/home/xxx/demo/venv/bin/python，对应替换即可。
3. 如果重装后依然报错，先清理冲突残留再重新安装，同样使用第一步拿到的Python路径执行：

   <替换为你的Python路径> -m pip uninstall -y multipledispatch dispatch
   <替换为你的Python路径> -m pip install multipledispatch
   

4. 修复校验：执行导入代码无报错即修复完成，可额外运行以下代码确认包路径正常：

   import multipledispatch
   print(multipledispatch.__file__)
   

补充说明：如果第一步输出的Python路径根本不在你创建的venv目录下，说明你当前Notebook选错了Kernel，直接在PyCharm的Jupyter界面右上角Kernel选择器中，切换到对应venv的解释器，重启Kernel后再执行导入即可。

内容的提问来源于stack exchange，提问作者Jack O'Neill