M3芯片Mac上pyenv安装失败：编译器无法生成可执行文件

每次使用pyenv安装Python时都会遇到编译失败问题，错误输出如下：

Installing Python-3.11.9...
python-build: use tcl-tk from homebrew
python-build: use readline from homebrew
python-build: use ncurses from homebrew

BUILD FAILED (OS X 14.5 using python-build 2.4.1-9-gb0cd5bf8)
...
Last 10 log lines:
checking for pkg-config... no
checking for --enable-universalsdk... no
checking for --with-universal-archs... no
checking MACHDEP... "darwin"
checking for gcc... clang
checking whether the C compiler works... no
configure: error: in `/var/folders/zt/pvq3drld4qgd783m1kzh17480000gq/T/python-build.20240605123450.20100/Python-3.11.9':
configure: error: C compiler cannot create executables
See `config.log' for more details
make: *** No targets specified and no makefile found.  Stop.

已尝试的操作：

• 删除并重装Homebrew
• 通过Homebrew安装所有构建依赖
• 采用Git克隆方式安装pyenv
• 删除并重装Xcode命令行工具
• 执行brew doctor检测无异常

遗漏的排查步骤 #

• 验证Clang编译器可用性
  终端执行clang --version确认编译器正常识别，再创建测试C文件test.c：

  #include <stdio.h>
  int main() {
      printf("Hello World\n");
      return 0;
  }
  

  运行clang test.c -o test编译，再执行./test，如果失败说明Clang本身存在问题，需优先修复编译器。

• 排查环境变量干扰
  终端执行echo $CFLAGS $CPPFLAGS $LDFLAGS查看是否存在异常编译参数（如错误路径、过时架构配置）。若有异常，临时清空变量后重试安装：

  CFLAGS="" CPPFLAGS="" LDFLAGS="" pyenv install 3.11.9
  

• 查看config.log详细错误
  错误提示中的config.log文件（路径：/var/folders/zt/pvq3drld4qgd783m1kzh17480000gq/T/python-build.20240605123450.20100/Python-3.11.9/config.log）记录了编译失败的具体原因，直接用cat命令或文本编辑器打开，定位核心错误（如库缺失、权限不足、架构不兼容等）。

• 确认系统架构匹配
  执行uname -m查看系统架构（arm64或x86_64），M系列芯片需确保Homebrew安装在/opt/homebrew，x86_64则在/usr/local。尝试指定架构编译：

  # arm64架构
  arch -arm64 pyenv install 3.11.9
  # x86_64架构
  arch -x86_64 pyenv install 3.11.9
  

• 检查临时目录权限
  编译使用的临时目录需具备读写权限，执行以下命令测试：

  mkdir -p /var/folders/zt/pvq3drld4qgd783m1kzh17480000gq/T/test && touch $_/testfile
  

  若失败，说明临时目录权限异常，需修复权限设置。

• 更新pyenv及插件
  进入pyenv安装目录更新至最新版本：

  cd ~/.pyenv && git pull
  cd ~/.pyenv/plugins/python-build && git pull
  

  更新完成后重试Python安装。

• 测试低版本Python兼容性
  尝试安装3.10.x等更低版本的Python，若安装成功，说明3.11.9与当前系统存在兼容性问题，可换用3.11系列其他版本（如3.11.8）尝试。

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