Linux安装pycairo报错缺失cairo.h头文件问题修复方案

从编译日志可以定位到两个核心问题：

1. 编译命令指定的系统头文件搜索路径全部为/usr/lib/include/前缀，但Debian/Ubuntu等主流Linux发行版通过apt安装libcairo2-dev后，cairo.h的实际存放路径为/usr/include/cairo/cairo.h，不在当前搜索范围内。
2. 你当前使用Anaconda环境的Python解释器，conda自带的独立编译工具链默认不会主动加载系统级的头文件路径配置，pip从源码构建pycairo时无法自动获取正确的依赖路径，直接触发头文件缺失报错。

按操作成本从低到高排序，优先选择靠前的方案：

方案1：通过conda安装预编译包（推荐） #

conda源提供了适配Anaconda环境的预编译pycairo包，不需要本地编译，直接绕开头文件依赖问题：

conda install pycairo

执行后等待安装完成即可，若默认源下载速度慢可先切换为国内conda镜像源。

方案2：pip安装时手动传入正确的编译参数 #

如果必须使用pip安装，先通过系统自带的pkg-config工具获取cairo的正确编译参数，传递给pip构建流程：

# 先确保pkg-config工具已安装
sudo apt update && sudo apt install -y pkg-config
# 清空之前的构建缓存，带上正确的编译参数安装
pip install pycairo --no-cache-dir CFLAGS="$(pkg-config --cflags cairo)" LDFLAGS="$(pkg-config --libs cairo)"

方案3：手动补全头文件搜索路径 #

如果上述命令仍报错，是conda的编译工具默认屏蔽了系统头文件路径，可临时将系统头文件目录加入环境变量后再安装：

# 将系统cairo头文件路径加入搜索优先级
export C_INCLUDE_PATH=/usr/include:/usr/include/cairo:$C_INCLUDE_PATH
export CPLUS_INCLUDE_PATH=/usr/include:/usr/include/cairo:$CPLUS_INCLUDE_PATH
# 重新执行安装
pip install pycairo --no-cache-dir

安装完成后执行以下命令验证功能正常：

python -c "import cairo; print('pycairo安装成功，版本为：', cairo.version)"

若正常输出版本号即为安装成功，若提示导入失败，先执行which pip和which python确认两个命令指向的是当前正在使用的Anaconda环境路径，避免包装到其他Python环境中。

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