Anaconda已安装igraph包 但Jupyter Notebook导入时提示模块未找到

常见根因 #

该问题不存在配置玄学，基本为两类原因：Jupyter使用的Python内核与安装包的conda环境不匹配、错装了无Python接口的igraph基础C库，按以下步骤逐一排查即可解决： #

分步排查操作 #

• 校验安装包的有效性
  切回你执行conda install -c conda-forge igraph的那个conda环境对应的Anaconda Prompt终端，执行如下校验命令：

  python -c "import igraph; print(igraph.__version__)"
  

  • 若命令直接抛出ModuleNotFoundError：说明你此前安装的是conda-forge源下独立的igraph C语言核心库，该包不包含Python可调用的模块接口，和Python绑定版本的包是独立拆分的。直接在当前环境补装Python绑定即可：

    conda install -c conda-forge python-igraph
    

  • 若命令可正常输出版本号：说明包本身无损坏，问题出在Jupyter的内核关联逻辑，继续后续排查。
• 核对Jupyter内核对应的解释器路径
  在报错的Jupyter Notebook中新建代码单元格，执行以下代码查看当前内核实际调用的Python解释器路径：

  import sys
  print(sys.executable)
  

  将输出路径和你安装igraph的conda环境路径做比对：
  • Windows平台base环境的正常解释器路径为Anaconda安装根目录\Anaconda3\python.exe
  • macOS/Linux平台base环境的正常解释器路径为~/anaconda3/bin/python
    若输出路径和安装包的环境路径不一致，说明Jupyter内核指向了其他无关的Python环境。
• 修复内核映射关系
  在安装了igraph的conda环境对应的Prompt终端，依次执行以下命令，为当前环境注册独立的Jupyter内核：

  # 安装内核注册所需的ipykernel组件
  conda install -c conda-forge ipykernel
  # 将当前环境注册为Jupyter可选内核
  python -m ipykernel install --user --name 自定义内核ID --display-name "Python (已安装igraph的环境)"
  

  操作完成后完全重启Jupyter服务，在Notebook页面右上角通过Kernel -> Change kernel菜单，选择刚才注册的对应环境内核，再尝试导入即可。
• 排查多版本环境的路径冲突
  若以上操作完成后仍报错，优先排查多Python版本共存的路径干扰：
  • 关闭所有后台运行的Jupyter进程、浏览器中打开的Notebook标签页
  • 不通过系统开始菜单、Anaconda Navigator的快捷入口启动Jupyter，直接在装了igraph的conda环境对应的Prompt终端中，执行jupyter notebook命令启动服务，避免Jupyter加载全局缓存的错误内核配置。

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