Python 3.12安装成功后终端仍显示旧版本，求助排查

先排查当前Python的指向 #

执行以下命令确认当前python/python3的实际路径：

• 查看命令路径：which python、which python3
• 查看软链接指向：ls -l $(which python)
• 检查已安装的Python版本列表：
  • 若用pyenv：pyenv versions
  • 若用Homebrew：brew info python@3.12（获取安装路径）

分场景解决 #

1. pyenv未正确初始化

如果用pyenv设置全局版本但不生效，先检查shell配置文件（~/.zshrc或~/.bash_profile）是否包含以下代码：

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

• 若没有，添加到配置文件末尾，执行source ~/.zshrc（对应你的shell配置）生效
• 重新执行pyenv global 3.12.0，重启终端后再验证版本

2. Homebrew安装的Python路径优先级不足

从brew info python@3.12中获取安装路径（通常是/usr/local/opt/python@3.12/bin或/opt/homebrew/opt/python@3.12/bin），将其加到PATH最前端：

export PATH="/usr/local/opt/python@3.12/bin:$PATH"

• 写入shell配置文件，执行source ~/.zshrc生效
• Homebrew安装的Python默认以python3为名，可添加别名统一：alias python='python3'（同样写入配置文件）

3. 官网安装的Python未加入PATH

官网安装的Python路径通常为/Library/Frameworks/Python.framework/Versions/3.12/bin，将其加入PATH最前端：

export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"

• 写入shell配置文件，执行source ~/.zshrc生效，重启终端验证

4. Shell缓存或别名干扰

• 检查是否有别名覆盖：alias python，若存在旧版本的别名，执行unalias python临时取消，或删除配置文件中对应的别名设置
• 清除shell命令缓存：hash -r，之后再执行python --version验证

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