pyenv-virtualenv激活虚拟环境后Python版本未变更问题求助

根因说明 #

该问题在M1芯片Mac的zsh环境下通常由以下原因导致：

• pyenv初始化语句在.zshrc中的加载顺序错误，shims路径被后续其他PATH配置覆盖
• 缺少pyenv shims路径的优先级配置
• pyenv-virtualenv的prompt修改逻辑干扰环境变量加载

修复步骤 #

1. 调整.zshrc配置顺序
   将pyenv相关初始化语句放在所有修改PATH的配置之后，包括Oh My Zsh加载、Homebrew初始化、其他工具（如conda、poetry）的初始化语句之后。M1芯片Mac需确保Homebrew的PATH配置（export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"）在pyenv配置之前。

2. 更新pyenv相关配置
   替换原有.zshrc中的两行pyenv初始化语句为以下内容：

export PYENV_VIRTUALENV_DISABLE_PROMPT=1
export PATH="$HOME/.pyenv/shims:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

3. 重载配置并验证
   执行以下命令重载zsh配置，之后重启终端：
   source ~/.zshrc

4. 激活测试
   重启终端后执行以下命令验证效果：

pyenv activate test_env
which python

正常应返回/Users/tom/.pyenv/versions/3.9.6/envs/test_env/bin/python

额外排查点 #

如果仍未生效，检查是否存在其他Python版本管理工具的自动初始化配置，将pyenv初始化语句移到所有这类配置的最后即可。

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