Windows10下MSYS2环境Python虚拟环境安装pycairo失败求助

核心原因 #

pip安装pycairo需要依赖系统级的cairo库及编译配置，但Python虚拟环境默认无法直接识别MSYS2通过pacman安装的系统级资源，导致编译时找不到依赖文件报错。

具体解决步骤 #

步骤1：补全MSYS2系统级依赖 #

打开对应架构的MSYS2终端（如UCRT64、MINGW64，需与你的Python环境匹配），执行以下命令安装完整的cairo及配套工具：

# UCRT64架构示例，MINGW64架构替换前缀为mingw-w64-x86_64-*
pacman -S mingw-w64-ucrt-x86_64-cairo mingw-w64-ucrt-x86_64-pkg-config

步骤2：给虚拟环境配置依赖路径 #

激活你的Python虚拟环境后，设置环境变量让pip能定位到cairo的配置文件：

# UCRT64架构路径
export PKG_CONFIG_PATH=/ucrt64/lib/pkgconfig
# MINGW64架构则用以下路径
# export PKG_CONFIG_PATH=/mingw64/lib/pkgconfig

步骤3：重新执行安装命令 #

在配置好环境变量的虚拟环境中，再次运行：

pip install pycairo

备选方案（快速复用系统包） #

若上述方法仍有问题，可在创建虚拟环境时添加参数，让虚拟环境直接访问MSYS2系统级安装的pycairo（会牺牲部分虚拟环境隔离性）：

# 创建带系统包访问权限的虚拟环境
python -m venv --system-site-packages my_venv
# 激活后无需再pip安装，直接使用pycairo即可

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