Rosetta 2环境下GCC编译Python异常问题求助

• 你的判断是对的，核心故障是双架构Homebrew路径污染：M系列Mac默认会并存两套Homebrew，arm64原生版位于/opt/homebrew，Rosetta 2转译的x86_64版位于/usr/local。如果Rosetta终端启动时没有把arm64版Homebrew的路径从环境变量中剔除，编译过程会优先拉取arm架构的头文件、动态/静态链接库，和x86架构的gcc-11、目标x86版Python的架构完全不匹配，直接触发各类链接错误、语法识别错误。
• 还有两个容易忽略的触发点：第一，你用的pyenv86一般是用户自己封装的x86调用别名，如果没有显式透传架构参数，构建脚本还是会从全局PATH扫描到arm64的依赖文件；第二，Python 3.7.0发布时间远早于M系列芯片上市，本身对gcc-11这类高版本编译器兼容性很差，哪怕路径完全正确，直接用gcc-11编译也会触发旧代码的语法报错。

• 第一步先确认纯Rosetta运行环境：右键终端图标勾选「使用Rosetta打开」，启动后执行arch，返回i386才是正确的x86转译环境。
• 第二步临时清理环境变量，彻底隔绝arm架构资源干扰，在当前终端直接执行以下命令：

unset HOMEBREW_PREFIX
unset PYENV_ROOT
export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
eval "$(/usr/local/bin/brew shellenv)"

执行完可以跑which brew验证，返回/usr/local/bin/brew才是正确的x86版Homebrew，后续不会再拉取/opt/homebrew下的arm架构资源。

• 第三步安装x86版编译依赖，不要用之前安装的gcc-11，Python 3.7对Rosetta环境下的Apple clang适配更好，能避开高版本gcc的兼容问题：

brew install openssl@1.1 readline sqlite3 xz zlib bzip2

• 第四步显式指定编译架构和依赖路径，执行安装命令，不要手动指定CC为gcc-11：

CFLAGS="-arch x86_64 -I$(brew --prefix openssl@1.1)/include -I$(brew --prefix readline)/include -I$(brew --prefix sqlite3)/include -I$(brew --prefix zlib)/include -I$(brew --prefix bzip2)/include" \
LDFLAGS="-arch x86_64 -L$(brew --prefix openssl@1.1)/lib -L$(brew --prefix readline)/lib -L$(brew --prefix sqlite3)/lib -L$(brew --prefix zlib)/lib -L$(brew --prefix bzip2)/lib" \
PYTHON_CONFIGURE_OPTS="--with-openssl=$(brew --prefix openssl@1.1)" \
arch -x86_64 pyenv install -v 3.7.0

• 给Shell加架构判断逻辑，自动匹配对应架构的Homebrew路径，从根源避免交叉污染。如果用zsh（Mac默认Shell）就在~/.zshrc里加如下配置，用bash就加在~/.bash_profile里：

if [ "$(arch)" = "arm64" ]; then
  eval "$(/opt/homebrew/bin/brew shellenv)"
else
  eval "$(/usr/local/bin/brew shellenv)"
fi

配置写完执行source ~/.zshrc（对应bash就source对应配置文件）生效，之后不管是开原生终端还是Rosetta终端，都会自动加载对应架构的brew路径，不会串。

• 不要给pyenv、pip这类工具做跨架构的全局别名，需要安装x86版Python时就用Rosetta打开终端操作，安装arm版Python就用原生终端操作，避免自定义别名封装带来的路径透传问题。
• 如果需要同时保留多架构的同版本Python，可以给pyenv安装的版本做区分命名，比如x86版3.7.0保持原名，arm版3.7.0安装后重命名为3.7.0-arm64，调用时不会搞混。

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