macOS下执行python/pip命令出现dyld错误的求助

问题描述 #

在macOS上运行python --version或pip相关命令时，出现错误：

dyld[19439]: rebase opcodes terminated early at offset 1 of 9040

多次卸载重装Python无效，在.zshrc中添加系统Python的别名后，终端直接调用Python暂时正常：

alias python=/usr/bin/python3
alias python3=/usr/bin/python3
alias pip=/usr/bin/pip3
alias pip=/usr/bin/pip3

但虚拟环境中的Python仍触发相同错误（比如nvim-dap调用项目venv的Python时），取消别名后which python指向/Users/<user>/.pyenv/shims/python。

解决方案 #

1. 彻底清理pyenv损坏的Python安装 #

• 列出当前pyenv管理的Python版本：

  pyenv versions
  

• 删除所有可疑的损坏版本：

  pyenv uninstall <出问题的版本号>
  

• 清理pyenv的shims缓存并重新生成：

  rm -rf ~/.pyenv/shims/*
  pyenv rehash
  

2. 重新安装Python（确保编译环境完整） #

• 先安装Xcode命令行工具（编译Python依赖）：

  xcode-select --install
  

• 重新安装目标Python版本（示例为3.11.0）：

  pyenv install 3.11.0
  

• 设置全局或本地Python版本：

  pyenv global 3.11.0  # 全局生效
  # 或针对项目设置：pyenv local 3.11.0
  pyenv rehash
  

3. 重建虚拟环境 #

之前的虚拟环境基于损坏的Python创建，必须重建：

• 删除旧虚拟环境：

  rm -rf /Users/..../api/.venv
  

• 用新安装的Python创建虚拟环境：

  python -m venv /Users/..../api/.venv
  

• 激活环境并重新安装依赖：

  source /Users/..../api/.venv/bin/activate
  pip install -r requirements.txt
  

4. 清理临时别名 #

问题解决后，可删除.zshrc中添加的系统Python别名，让pyenv正常管理版本切换，避免后续版本冲突。

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