MacOS安装Apache Superset 6.0.0报错：找不到'ios'文件

问题根源 #

这个报错是因为Python 3.12与Superset 6.0.0默认依赖的旧版pandas存在兼容性冲突，编译时找不到系统标准库的ios.h文件（该文件在XCode SDK目录下，不在OpenSSL目录）。

具体解决方法 #

• 先安装兼容Python3.12的pandas版本
  先单独安装对Python3.12支持完善的pandas版本（比如2.2.0及以上），再安装Superset避免重新编译旧版本：

  pip install pandas>=2.2.0
  pip install apache-superset
  

• 添加XCode SDK头文件路径到编译参数
  把XCode SDK的系统头文件路径加入CFLAGS，让clang++能找到ios.h：

  export CFLAGS="-I$(xcrun --show-sdk-path)/usr/include $CFLAGS"
  pip install apache-superset
  

• 强制使用预编译wheel包跳过本地编译
  安装时指定只使用预编译的wheel包，避免本地编译出错：

  pip install apache-superset --only-binary :all:
  

• 清理缓存后重新安装
  如果之前有残留的编译缓存，先清理再操作：

  pip uninstall -y pandas
  pip cache purge
  pip install pandas>=2.2.0
  pip install apache-superset
  

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