Python 3.9.6+MacOS Sonoma14.3.1下安装pyregion失败求助

问题概述 #

环境：Python 3.9.6、macOS Sonoma 14.3.1
安装pyregion时遇到的核心问题：

• 标准pip安装失败，提示Failed building wheel for pyregion
• 升级numpy、pip后问题依旧
• 源码安装阶段，先缺失Cython依赖；安装Cython 3.0.9后出现编译错误，核心报错为：

  incompatible pointer to integer conversion returning 'void ' from a function with result type 'int' [-Wint-conversion]
  该错误由import_array()宏展开时返回NULL（void类型）与函数预期int返回值不匹配导致

分步解决指南 #

1. 降级Cython至兼容版本 #

Cython 3.x系列与旧版pyregion的numpy API适配存在冲突，需降级到稳定兼容的2.x版本：

pip3 install cython==0.29.36

2. 设置编译环境变量 #

通过环境变量禁用numpy的废弃API警告，并修正编译类型转换规则：

export CFLAGS="-DNPY_NO_DEPRECATED_API=NPY_1_7_API_VERSION"

3. 执行安装 #

方式一：使用pip安装（推荐）

添加--no-build-isolation参数，强制使用当前环境的依赖进行编译：

pip3 install pyregion --no-build-isolation

方式二：源码安装

1. 获取pyregion源码包（对应Python 3.9的兼容版本）
2. 解压后进入源码目录，执行：

python3 setup.py install

4. 验证安装结果 #

启动Python交互环境，执行以下命令确认安装成功：

import pyregion
print(pyregion.__version__)

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