You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何解决MacOSX下Jupyter Lab安装pycairo的wheel编译失败错误?

解决Mac Ventura 13.3 + Python 3.12.1下pycairo编译失败(ERROR: Failed building wheel for pycairo)的问题

针对你在复现生物建模教程的绘图代码时遇到的pycairo编译失败问题,以下是适配Mac Ventura环境的解决方案:

核心原因

pycairo是基于系统级cairo库的Python绑定,直接用pip安装需要本地编译环境和系统依赖库,Mac Ventura默认缺少这些编译依赖,导致wheel构建失败。


分步解决方案

1. 安装系统级依赖(必做)

首先用Homebrew安装cairo及编译工具(若未安装Homebrew,先执行第一行命令安装):

# 安装Homebrew(如果还没装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装cairo和pkg-config
brew install cairo pkg-config

2. 指定依赖路径并安装pycairo

根据你的Mac芯片类型,设置环境变量让pip找到Homebrew安装的库,再安装pycairo:

  • Apple Silicon(M系列芯片):
    在Jupyter Lab单元格中执行:
    !export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig" && pip install pycairo
    
  • Intel芯片:
    在Jupyter Lab单元格中执行:
    !export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig" && pip install pycairo
    

3. 备选方案:用conda安装(绕过编译)

如果pip编译仍失败,可尝试用conda直接安装预编译好的pycairo:

!conda install -c conda-forge pycairo

验证安装

安装完成后,运行以下代码确认pycairo是否正常工作:

import cairo
print(cairo.__version__)

能正常输出版本号后,再执行你的绘图代码即可:

plot(network, vertex_label=vertex_names, vertex_label_size=8, edge_arrow_width=1, edge_arrow_size=0.5, autocurve=True, target='myfile.pdf')

内容的提问来源于stack exchange,提问作者user2954167

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.26 19:52:15