M1芯片Mac全新安装Python后终端显示版本号异常问题咨询

问题原因 #

Xcode 命令行工具（CLT）内置了 Python 3.8.2 版本，你完成 CLT 安装后，系统环境变量 PATH 中 CLT 的工具路径优先级高于你手动安装的 Python 3.9.7 对应的路径，终端执行 python3 时会优先匹配到优先级更高的 CLT 内置版本，才会出现版本不符合预期的情况。

操作错误说明 #

不属于核心操作错误，属于 macOS 系统默认路径优先级的常见问题，也可能是 Python 官方安装包写入 PATH 配置时，没有适配你当前使用的 shell 配置文件（macOS 近年默认 shell 为 zsh，部分旧安装包默认只更新 bash 配置）导致的。

修复方法 #

• 首先确认 Python 3.9.7 安装成功，执行命令查看官方安装包的默认路径是否存在：
  ls /Library/Frameworks/Python.framework/Versions/
  如果返回结果包含 3.9 目录，说明安装正常。
• 编辑当前 shell 的配置文件：
  如果你用的是 macOS 默认的 zsh，执行 nano ~/.zshrc 打开配置文件；如果用的是 bash，执行 nano ~/.bash_profile
  在文件末尾加入以下三行配置：

export PATH="/Library/Frameworks/Python.framework/Versions/3.9/bin:$PATH"
alias python3="/Library/Frameworks/Python.framework/Versions/3.9/bin/python3.9"
alias pip3="/Library/Frameworks/Python.framework/Versions/3.9/bin/pip3.9"

按 Ctrl+O 保存，按 Ctrl+X 退出编辑器。

• 执行命令让配置立即生效：
  zsh 环境执行 source ~/.zshrc，bash 环境执行 source ~/.bash_profile
• 验证修复结果，执行 python3 --version，确认返回结果为 Python 3.9.7 即可。

如果不想修改配置，也可以直接用 python3.9 命令调用你安装的 3.9.7 版本，pip3.9 调用对应版本的包管理工具。

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