M1芯片Mac pip安装apache-flink因numpy编译错误安装失败

这个报错和M1芯片的arm64架构直接相关：旧版PyFlink（apache-flink的Python包）的依赖规则锁死了1.21以下的低版本numpy，这些低版本numpy没有提供arm64架构的预编译安装包，pip安装时会自动拉取源码本地编译，编译脚本里带了PowerPC平台专用的-faltivec编译参数，Mac端的clang编译器不识别这个参数就会直接报错退出。
你之前提前安装numpy没生效，是因为pip默认会在隔离环境里构建依赖，不会复用你全局提前装的numpy版本，必须加参数跳过隔离构建才会用到本地已装的兼容版numpy。

• 先确认当前Python的运行架构：执行file $(which python3)，看输出是否带arm64标识，避免出现Rosetta转译的x86进程和原生arm进程混用的问题
• 确认PyFlink的依赖版本约束：执行pip3 index versions apache-flink，对应你要安装的PyFlink版本查看它要求的numpy版本范围，确认是不是锁定了无arm64预编译包的旧版本
• 单独安装报错日志里提到的对应版本numpy，复现相同的faltivec报错，确认问题确实出在numpy编译环节，排除其他依赖干扰

按成功率从高到低排序：

• 方案1：用Conda环境安装（最稳定，不用折腾编译）
  安装arm64版本的miniconda，创建独立虚拟环境后从conda-forge源安装，conda会自动匹配arm架构预编译好的所有依赖，完全不会触发源码编译：

  conda create -n pyflink python=3.8 -y
  conda activate pyflink
  conda install -c conda-forge apache-flink
  

• 方案2：强制pip使用预编译包，跳过源码构建
  提前安装适配M1芯片的numpy版本，再安装PyFlink时加参数禁止隔离构建、优先使用二进制包，跳过numpy的源码编译环节：

  pip3 install numpy==1.23.5
  pip3 install apache-flink --no-build-isolation --prefer-binary
  

• 方案3：通过Rosetta 2转译运行x86版Python
  找到终端应用，右键点「显示简介」，勾选「使用Rosetta打开」，重启终端后安装x86架构的Python 3.8，再执行pip安装命令，此时所有依赖都会走x86_64架构的预编译包，不会触发altivec相关的编译参数错误。
• 方案4：临时覆盖编译参数（仅作临时测试用，不推荐生产环境用）
  安装前手动注入编译参数，替换掉不兼容的-faltivec选项：

  export CFLAGS="-maltivec -include altivec.h"
  pip3 install apache-flink
  

注意：你当前用的Python 3.8是macOS系统自带的版本，本身做了很多定制化修改，权限和依赖链接都有特殊配置，不管用上面哪个方案，都建议先通过pyenv或者conda装独立的Python环境，不要直接往系统自带Python里装第三方包，很容易出现权限报错或者系统依赖冲突。

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