M1芯片设备通过pyenv安装Python 3.9.1失败求助

问题背景 #

在Monterey 12.6.1环境下，使用x86_64 Homebrew的gcc-12配合pyenv安装Python 3.9.1时，触发Xcode 14.1 SDK中float.h的编译错误，核心报错为：

/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include/float.h:76:21: error: implicit declaration of function '__builtin_flt_rounds'; did you mean '__builtin_llround'? [-Werror=implicit-function-declaration]

解决方法 #

1. 添加编译参数绕过隐式声明错误 #

将隐式函数声明的错误降级为警告，执行以下命令安装：

CC="$(brew --prefix gcc)/bin/gcc-12" CFLAGS="-Wno-error=implicit-function-declaration" pyenv install 3.9.1 -v

2. 切换使用Xcode自带的Clang编译器 #

brew的gcc与Xcode 14.1 SDK存在兼容性问题，尝试直接用系统Clang编译：

pyenv install 3.9.1 -v

或者显式指定Clang：

CC="clang" pyenv install 3.9.1 -v

3. 确保Xcode命令行工具配置正确 #

先更新并关联正确的命令行工具：

xcode-select --install
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

重启终端后再次尝试安装。

4. 更新pyenv及Python编译脚本 #

更新pyenv到最新版本：

brew upgrade pyenv

同步python-build的最新补丁（包含对新Xcode环境的适配）：

cd "$(pyenv root)"/plugins/python-build && git pull

问题原因 #

Xcode 14.1的MacOSX SDK中，float.h使用了GCC内置函数__builtin_flt_rounds，但brew提供的gcc-12在处理该宏时未正确识别函数声明，触发了严格编译错误；而Python 3.9.1的代码未适配这种新的编译严格性，因此需要通过调整编译参数、更换编译器或更新工具链来解决。

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