使用pip3.12安装pycairo失败，请求技术支持

问题说明 #

在激活的Python虚拟环境（pip已升级至最新版）中执行pip3.12 install pycairo时，出现wheel构建失败的错误，核心原因是pkg-config无法找到Cairo开发包的配置文件cairo.pc。关键报错片段如下：

Package cairo was not found in the pkg-config search path.
Perhaps you should add the directory containing `cairo.pc'
to the PKG_CONFIG_PATH environment variable
Package 'cairo', required by 'virtual:world', not found
Command '['pkg-config', '--print-errors', '--exists', 'cairo >= 1.15.10']' returned non-zero exit status 1.

解决方案 #

1. 安装系统级Cairo开发依赖（优先推荐） #

pycairo需要依赖系统级的Cairo开发库，直接安装对应发行版的包即可解决大部分问题：

• Debian/Ubuntu 系列：

  sudo apt-get install libcairo2-dev pkg-config
  

• Fedora/RHEL 系列：

  sudo dnf install cairo-devel pkg-config
  

• Arch Linux 系列：

  sudo pacman -S cairo pkg-config
  

安装完成后，回到激活的虚拟环境重新执行安装命令：

pip3.12 install pycairo

2. 手动指定PKG_CONFIG_PATH（适用于已安装Cairo但仍报错的情况） #

如果系统中已存在Cairo，但pkg-config无法定位cairo.pc，按以下步骤操作：

1. 查找cairo.pc的位置：

   find /usr -name "cairo.pc" 2>/dev/null
   

2. 临时设置环境变量（替换为你找到的实际目录）：

   export PKG_CONFIG_PATH=/usr/lib/x86_64-linux-gnu/pkgconfig/
   

3. 重新安装pycairo：

   pip3.12 install pycairo
   

若需要永久生效，可将export PKG_CONFIG_PATH=你的实际路径添加到~/.bashrc或~/.zshrc文件中，执行source ~/.bashrc（对应你的shell配置）使设置生效。

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