M1 Pro MacBook改用户名后pip报‘bad interpreter’错误修复

问题根源 #

修改用户名后，pyenv安装的Python 3.10.6可执行文件（包括pip）的解释器路径仍指向旧用户名/Users/ht，系统无法找到对应路径的Python解释器，从而报错。

解决方法 #

方法1：重新安装对应Python版本（最稳妥） #

• 卸载当前的3.10.6版本：

  pyenv uninstall 3.10.6
  

• 重新安装该版本：

  pyenv install 3.10.6
  

• 设置全局或局部使用该版本（按需选择）：

  pyenv global 3.10.6
  # 或局部项目设置：pyenv local 3.10.6
  

• 验证pip是否恢复正常：

  pip --version
  

方法2：批量修改可执行文件的路径（无需重装） #

• 进入pyenv对应版本的bin目录：

  cd ~/.pyenv/versions/3.10.6/bin
  

• 用sed命令批量替换所有文件中的旧路径为新路径（M1 Mac需加''参数）：

  sed -i '' 's/\/Users\/ht/\/Users\/haitao/g' *
  

• 验证修改结果，查看pip文件的首行：

  head -n 1 pip
  

  正常应显示#!/Users/haitao/.pyenv/versions/3.10.6/bin/python3.10
• 再次测试pip命令是否正常运行

额外检查：确认pyenv配置无旧路径 #

• 查看shell配置文件（~/.zshrc或~/.bashrc）中的pyenv相关配置：

  cat ~/.zshrc | grep pyenv
  

  正常配置应类似：

  export PYENV_ROOT="$HOME/.pyenv"
  command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
  eval "$(pyenv init -)"
  

• 若存在旧用户名路径，修改后重新加载配置：

  source ~/.zshrc
  

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