pyenv识别.python-version文件但运行python时未使用指定版本

核心原因：pyenv的shims路径未优先于其他Python路径 #

pyenv是通过~/.pyenv/shims目录下的代理脚本拦截python命令来切换版本的。如果你的PATH环境变量中，其他Python的安装路径（比如你这里的/Users/username/.pyenv/versions/3.12.6/bin）排在shims路径前面，系统就会优先调用那个路径下的Python，忽略pyenv的版本设置。

解决步骤 #

1. 检查当前PATH顺序 #

先确认shims路径的位置：

echo $PATH

查看输出里是否有/Users/username/.pyenv/shims，并且它是否在/Users/username/.pyenv/versions/3.12.6/bin之前。如果不是，就需要调整。

2. 修复shell配置文件 #

打开你的shell配置文件（zsh用~/.zshrc，bash用~/.bashrc或~/.bash_profile），确保添加了正确的pyenv初始化代码，并且放在所有修改PATH的配置（比如brew、conda的初始化代码）之前：

# 添加以下内容到配置文件顶部
export PYENV_ROOT="$HOME/.pyenv"
command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

3. 重新加载配置或重启终端 #

执行命令让配置生效：

source ~/.zshrc  # zsh用户执行这个，bash用户换成source ~/.bashrc

或者直接关闭终端再重新打开。

4. 验证修复效果 #

再次执行以下命令，确认版本正确：

python --version  # 应该显示3.10.12
which python      # 应该指向/Users/username/.pyenv/shims/python

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