安装pysat失败：出现use of undeclared identifier 'NUMPY_IMPORT_ARRAY_RETVAL'错误

你在MacOS Catalina 10.15.7上用Python3.8安装pysat时遇到的问题，本质是依赖的pandas源码编译失败——核心错误是NUMPY_IMPORT_ARRAY_RETVAL未声明，还伴随NumPy废弃API的警告。我整理了几个靠谱的解决办法：

方法一：用预编译包避免源码编译（最推荐） #

旧版本pandas在新环境下源码编译容易出兼容问题，直接用官方预编译的二进制包就能绕开这个坑：

1. 先升级pip和相关工具，确保能正确获取预编译包：

   pip install --upgrade pip setuptools wheel
   

2. 安装预编译的pandas：

   pip install pandas --only-binary :all:
   

3. 再执行pysat安装：

   pip install pysat
   

方法二：指定兼容Python3.8的pandas版本 #

Python3.8和pandas 1.3.x系列兼容性很好，先锁定这个版本的pandas再装pysat：

1. 安装指定版本的pandas：

   pip install pandas==1.3.5
   

2. 继续安装pysat：

   pip install pysat
   

方法三：设置编译宏解决API兼容问题（适合必须源码编译的场景） #

如果上面两种方法都不行，你可以通过环境变量告诉编译器处理NumPy的API兼容问题：

1. 临时设置环境变量（当前终端会话内有效）：

   export CFLAGS="-DNPY_NO_DEPRECATED_API=NPY_1_7_API_VERSION"
   

2. 再执行pysat安装命令：

   pip install pysat
   

错误原因说明 #

这个问题源于pandas旧版本源码和新版NumPy的API不匹配：NumPy更新后废弃了旧API，而pandas源码里没有正确定义对应的兼容宏，导致编译时找不到NUMPY_IMPORT_ARRAY_RETVAL标识符。用预编译包或者指定兼容的pandas版本，都能避开源码编译的兼容性问题。

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