应使用 pyenv 管理多版本 Python：先 brew install pyenv，再配置 ~/.zshrc 并 source 生效，然后 pyenv install 3.11.9、pyenv global 3.11.9，最后 python --version 验证。
如果您在 macOS 终端中运行 python 命令时调用的是 Python 2.7，而您需要使用 Python 3.x 版本进行开发或执行脚本，则需明确区分系统自带 Python 与用户安装的 Python 3，并正确配置默认调用版本。以下是实现 Python 版本切换与默认版本指定的具体操作步骤：
一、通过 pyenv 管理多版本 Python
pyenv 是专为 Unix-like 系统设计的 Python 版本管理工具，支持在同一系统中安装、切换多个互不干扰的 Python 版本，且不影响系统预装 Python。
1、打开终端，执行命令安装 pyenv：
brew install pyenv
2、配置 shell 初始化脚本（以 zsh 为例）：
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
立即学习“Python免费学习笔记（深入）”；
3、重启终端或执行 source ~/.zshrc 使配置生效
4、列出所有可安装的 Python 版本：
pyenv install --list | grep "^\s*[0-9]\+\.[0-9]\+\.[0-9]\+$"
5、安装指定 Python 3 版本（例如 3.11.9）：
pyenv install 3.11.9
6、设置全局默认 Python 版本：
pyenv global 3.11.9
7、验证当前默认版本：
python --version
此时终端中 python 命令将指向 pyenv 托管的 3.11.9 版本，且该设置对当前用户所有 shell 会话生效。
二、通过修改 shell 别名实现快速切换
若仅需临时或轻量级切换，可在 shell 配置文件中定义别名，覆盖系统默认的 python 命令行为，无需额外工具依赖。
1、确认已安装的 Python 3 可执行文件路径：
which python3
2、编辑 ~/.zshrc 文件：
nano ~/.zshrc
3、在文件末尾添加以下两行（假设 python3 实际路径为 /usr/local/bin/python3）：
alias python="/usr/local/bin/python3"
alias pip="/usr/local/bin/pip3"
4、保存并退出编辑器，执行 source ~/.zshrc 重载配置
5、验证别名是否生效：
python --version
此时 输入 python 即等同于执行 python3，且该映射对当前用户所有新启动的终端有效。
三、通过修改 PATH 环境变量优先级切换默认版本
macOS 根据 PATH 中目录的排列顺序查找可执行文件。将包含目标 Python 3 可执行文件的目录置于 PATH 前端，可使其优先于系统自带 Python 被调用。
1、获取 Python 3 安装路径（如通过 Homebrew 安装）：
brew --prefix python@3.11
2、查看当前 PATH 设置：
echo $PATH
3、编辑 ~/.zshrc 文件，在末尾添加（以 Homebrew 安装的 Python 3.11 为例）：
export PATH="/opt/homebrew/opt/python@3.11/bin:$PATH"
4、保存后执行 source ~/.zshrc
5、检查 python 命令实际调用路径：
which python
若输出为 /opt/homebrew/opt/python@3.11/bin/python，则说明 PATH 重排已成功让 Python 3.11 成为默认 python 解释器。
四、使用 Homebrew 安装 Python 3 并启用 python3 命令
Homebrew 安装的 Python 3 默认不覆盖系统 python 命令，但会提供独立的 python3 和 pip3 命令，适用于明确区分版本的场景。
1、确保已安装 Homebrew，执行：
brew update
2、安装 Python 3：
brew install python@3.11
3、验证安装结果：
python3 --version
4、检查 pip3 是否可用：
pip3 list
5、如需将 python3 设为默认，可创建软链接（需管理员权限）：
sudo ln -sf /opt/homebrew/bin/python3 /usr/local/bin/python
注意：此操作会覆盖 /usr/local/bin 下的 python 符号链接，执行前请确认 /usr/local/bin/python 不被其他关键工具依赖。
