PyCharm中无法导入Python的graph-tool模块问题求助

报错信息 #

Traceback (most recent call last):
  File "/Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/code.py", line 90, in runcode
    exec(code, self.locals)
  File "<input>", line 1, in <module>
  File "/Applications/PyCharm.app/Contents/plugins/python/helpers/pydev/_pydev_bundle/pydev_import_hook.py", line 21, in do_import
    module = self._system_import(name, *args, **kwargs)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named 'graph_tool'

问题背景 #

PyCharm与Python 3.11均通过Homebrew安装，怀疑graph-tool未关联至当前Python环境，多次尝试关联操作无效。

解决步骤 #

1. 确认graph-tool的Homebrew安装状态 #

打开终端执行命令，检查是否已安装graph-tool：

brew list | grep graph-tool

若无输出，先执行安装：

brew install graph-tool

2. 定位Homebrew安装的Python3.11路径 #

终端执行命令获取当前Python3.11的系统路径：

which python3.11

输出示例：/opt/homebrew/bin/python3.11（Apple Silicon）或/usr/local/bin/python3.11（Intel芯片）

3. 验证graph-tool是否在目标Python环境的site-packages中 #

执行命令查看当前Python环境的site-packages路径：

python3.11 -c "import site; print(site.getsitepackages())"

手动检查输出路径下是否存在graph_tool文件夹。

4. 配置PyCharm使用正确的Python解释器 #

打开PyCharm操作：

• 进入File > Settings > Project: [你的项目名] > Python Interpreter
• 点击右上角齿轮图标，选择Add
• 切换到System Interpreter，选择步骤2中获取的Python3.11路径，确认保存
• 等待PyCharm加载包列表，检查graph-tool是否已出现在已安装包中

5. 手动软链接修复（极端情况） #

若Homebrew安装的graph-tool路径与当前Python环境的site-packages不匹配，可手动创建软链接：

ln -s /usr/local/lib/python3.11/site-packages/graph_tool [步骤3输出的site-packages路径]/graph_tool

替换命令中的路径为实际路径即可。

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