如何修复pyenv配置以正确安装Python包？

问题描述 #

已按建议卸载本地非Mac默认的Python版本，通过brew安装了pyenv-virtualenv。但使用pip/pip3/python/python3安装包时，包会被安装到/opt/homebrew/lib/python3.10/site-packages目录，而该目录对应的Python3.10已不在/opt/homebrew中。已执行brew doctor和brew cleanup --prune=all，结果无异常。

问题总结 #

包被安装到错误路径，导致运行时提示“模块未找到”，无法正常使用。

环境信息 #

• 设备：MacBook Air M1 Ventura
• 编辑器：Visual Studio Code 1.75.0

版本检查 #

myusername@MacBook ~ % which pip
/Users/myusername/.pyenv/shims/pip

myusername@MacBook ~ % which pip3
/Users/myusername/.pyenv/shims/pip3

myusername@MacBook ~ % which python
/Users/myusername/.pyenv/shims/python

myusername@MacBook ~ % which python3
/Users/myusername/.pyenv/shims/python3

myusername@MacBook ~ % pyenv versions
  system
* 3.11.1 (set by /Users/myusername/.pyenv/version)
  3.11.1/envs/venv_mypyenv_playground
  venv_mypyenv_playground

myusername@MacBook ~ % which brew
/opt/homebrew/bin/brew

PATH检查 #

myusername@MacBook ~ % echo $PATH
/Users/myusername/.pyenv/shims:/Users/myusername/.pyenv/bin:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/System/Cryptexes/App/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Library/TeX/texbin:/usr/local/go/bin:/Library/Apple/usr/bin

当前PATH包含/Users/myusername/.pyenv/shims，但不存在/Users/myusername/.pyenv/bin目录，实际存在的是/Users/myusername/.pyenv/versions/3.11.1/bin。

疑问与尝试 #

1. 这是否是问题根源？如何正确修改PATH？
2. 曾尝试将export PATH="$PYENV_ROOT/bin:$PATH"改为export PATH="$PYENV_ROOT/versions/3.11.1/bin:$PATH"，但无效，包仍被安装到homebrew目录。
3. 卸载brew重新尝试是否可行？会破坏现有pyenv配置吗？

Bash与ZSH配置 #

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

.bashrc is empty

.zprofile
# set PATH, MANPATH, etc., for Homebrew.
eval "$(/opt/homebrew/bin/brew shellenv)"

.zshrc
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
if command -v pyenv 1>/dev/null 2>&1; then
  eval "$(pyenv init -)"
fi

执行source .bash_profile时提示pyenv:12: command not found: pyenv。

解决方案建议 #

1. 修复pyenv初始化顺序与PATH优先级 #

问题核心是Homebrew的PATH优先级可能覆盖了pyenv的shims，或pyenv初始化未正确生效：

• 调整ZSH配置（M1 Mac默认用ZSH），将pyenv配置放在Homebrew之后，确保shims优先：
  修改.zshrc：

  # 先加载Homebrew环境
  eval "$(/opt/homebrew/bin/brew shellenv)"
  # 再配置pyenv
  export PYENV_ROOT="$HOME/.pyenv"
  if command -v pyenv 1>/dev/null 2>&1; then
    eval "$(pyenv init --path)"  # 关键：自动将shims放到PATH最前
    eval "$(pyenv init -)"
  fi
  

• 精简.bash_profile，避免手动PATH前缀覆盖：

  export PYENV_ROOT="$HOME/.pyenv"
  eval "$(pyenv init --path)"
  eval "$(pyenv init -)"
  

2. 验证pyenv关联状态 #

执行以下命令确认Python和pip的实际指向：

python --version  # 应输出3.11.1
pip --version     # 应指向/Users/myusername/.pyenv/versions/3.11.1/bin/pip

若输出异常，执行pyenv rehash更新shims后重启终端。

3. 清理Homebrew残留Python链接 #

手动删除已卸载Python3.10的残留软链接：

rm -f /opt/homebrew/bin/python3 /opt/homebrew/bin/pip3

再执行pyenv rehash更新shims。

4. 关于卸载Homebrew的说明 #

• 卸载Homebrew不会直接破坏pyenv配置（pyenv文件均在~/.pyenv），但不建议轻易操作，优先尝试上述修复步骤。
• 若需卸载，先备份~/.pyenv目录，恢复时将备份放回原位置即可。

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