Intel Mac已安装cairo但Python提示No module named cairo的问题求助

架构老林

2026-6-21

解决Intel Mac上运行手写AI工具时的cairo模块导入错误

我在Intel Mac上尝试运行一款名为“My Text in Your Handwriting”的文字转手写AI（项目地址：https://github.com/thaines/helit/tree/master/handwriting），安装过程中遇到模块导入错误，报错信息如下：

Traceback (most recent call last):
  File "image_viewer.py", line 17, in <module>
    from viewer import *
  File "/*My home Folder*/helit/utils_gui/viewer.py", line 15, in <module>
    import cairo
ImportError: No module named cairo

之前遇到类似缺失模块问题时，我通常用brew install *module*安装，但执行brew install cairo时，系统提示该模块已安装。我是手动安装Python依赖的新手，习惯一键安装方式，想知道是否版本不兼容或遗漏了步骤。

原因及解决步骤

1. 安装Python绑定模块pycairo

brew install cairo安装的是系统级图形库，Python需要的是对应的pycairo绑定模块，直接用pip安装：

针对Python2：
```
pip install pycairo
```
针对Python3：
```
pip3 install pycairo
```

2. 手动指定cairo路径安装（若直接安装失败）

如果pip安装pycairo时提示找不到cairo库，可指定brew安装的cairo配置路径：

PKG_CONFIG_PATH="/usr/local/lib/pkgconfig" pip3 install pycairo

（Intel Mac上brew默认路径为/usr/local，若你的brew安装路径不同，替换对应pkgconfig路径即可）

3. 匹配Python环境与pip

若你有多个Python版本（系统自带、brew版、conda环境等），需确保运行脚本的Python环境已安装pycairo：

查看当前运行脚本的Python路径：
```
which python
```
或
```
which python3
```
使用对应路径的pip安装pycairo，比如输出为/usr/local/bin/python3，则执行：
```
/usr/local/bin/pip3 install pycairo
```