安装pyenv后Mac上brew安装Python失败，卸载后问题仍存在

我之前也碰到过一模一样的坑，pyenv的残留配置加上旧版本Xcode的双重夹击，确实会把Homebrew的Python编译搞崩。咱们一步步拆解解决：

1. 先搞定Xcode版本问题（硬要求） #

系统提示Xcode 9.2过旧是核心原因之一——Homebrew编译Python这类软件需要较新的Xcode工具链支持，旧版本会触发一堆兼容性编译错误：

• 打开App Store搜索Xcode，更新到9.3及以上版本（如果你的系统支持更高版本，建议更到最新兼容版）；
• 安装完成后务必打开Xcode一次，同意协议并等待组件自动安装；
• 再在终端执行以下命令，确保Command Line Tools是最新且协议已生效：

  xcode-select --install
  sudo xcodebuild -license accept
  

2. 彻底清理pyenv的残留配置 #

卸载pyenv后，很多人会漏掉shell配置文件里的初始化代码，这些残留会持续干扰Homebrew的编译环境：

• 打开你的shell配置文件（比如~/.zshrc、~/.bash_profile、~/.bashrc），找到以下类似代码并删除：

  export PYENV_ROOT="$HOME/.pyenv"
  export PATH="$PYENV_ROOT/bin:$PATH"
  eval "$(pyenv init -)"
  

• 保存文件后，重启终端，或者执行source ~/.zshrc（对应你正在使用的shell）让配置生效；
• 验证清理效果：执行echo $PATH确保~/.pyenv/shims不在输出里；执行echo $PYENV_ROOT应该返回空值。

3. 重置Homebrew环境并重新安装Python #

现在清理Homebrew的缓存和错误状态，重新尝试安装：

• 先清理旧的编译残留和失败的Python安装：

  brew cleanup
  brew uninstall --force python
  

• 运行brew doctor，按照输出的提示修复所有问题（比如缺失的依赖、权限异常等）；
• 最后重新安装Python：

  brew install python
  

问题根源说明 #

pyenv会修改你的PATH环境变量，让系统优先调用pyenv管理的Python版本。即使卸载了pyenv，残留的配置还是会让Homebrew在编译时调用错误的Python环境，导致Sphinx（Python文档生成工具）找不到正确的pdb模块，触发AttributeError。再加上旧版本Xcode的工具链不兼容，双重问题直接导致编译彻底失败。

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