Google Colab中StellarGraph 1.2.1已安装却无法导入的问题

问题场景 #

在Google Colab中将Python版本切换至3.7.16后，执行%pip install -q stellargraph[demos]==1.2.1安装指定版本库，通过pip freeze/!pip list确认已安装，但执行import stellargraph as sg时仍报ModuleNotFoundError: No module named 'stellargraph'。

解决方案 #

1. 校验Python与pip的环境一致性 #

Colab切换Python版本后，pip可能绑定到了旧版本Python环境，导致包安装路径不匹配。执行以下命令查看两者路径：

!which python
!which pip

若输出路径不一致，说明当前pip不属于正在使用的Python 3.7.16环境。

2. 使用对应环境的pip重新安装 #

卸载现有StellarGraph，并用当前Python环境的pip重新安装：

!pip uninstall -y stellargraph
!python -m pip install -q stellargraph[demos]==1.2.1

python -m pip会强制使用当前Python环境关联的pip工具，确保包安装到正确路径。

3. 验证安装路径匹配 #

检查StellarGraph的安装位置是否在当前Python的模块搜索路径中：

!python -c "import sys; print('\n'.join(sys.path))"
!pip show stellargraph | grep Location

确认Location输出的路径存在于sys.path列表内。

4. 重启Colab运行时 #

安装完成后，点击Colab顶部菜单栏「Runtime」→「Restart runtime」，重启后再执行导入语句：

import stellargraph as sg
sg.utils.validate_notebook_version("1.2.1")

5. 直接使用官方Notebook的初始化代码 #

参考目标Notebook的官方初始化逻辑，避免手动切换环境后出现路径冲突，直接执行官方提供的安装与导入代码块。

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