用pyenv管理python版本是最安全可逆的方案：先brew install pyenv，再配置~/.zshrc并source，接着pyenv install 3.12.4，最后pyenv global 3.12.4即可使python命令指向新版。
你在Mac终端输入python命令时，它仍调用系统自带的Python 2.7或旧版Python 3，而你实际开发需要的是最新稳定版Python 3.11或3.12——这不是版本没装好，而是shell根本没把python命令指向你想要的那个解释器。
用 pyenv 管理并切换全局默认版本
这是最安全、可逆、支持多版本共存的方案，适用于需要频繁切换或维护多个项目的开发者。
第一步：安装 pyenv
在终端执行：brew install pyenv
第二步：配置 shell 初始化
向 ~/.zshrc（macOS Catalina 及之后默认 shell）追加三行：
export PYENV_ROOT="$HOME/.pyenv"command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"eval "$(pyenv init -)"
第三步：重载配置source ~/.zshrc
这一步必须执行，否则 pyenv 命令不可用。
第四步：安装目标 Python 版本
例如安装 3.12.4：pyenv install 3.12.4
安装过程耗时较长，期间不要关闭终端。若报错“no build tools”，需先安装 Xcode Command Line Tools：xcode-select --install
第五步：设为全局默认pyenv global 3.12.4
【此操作会直接影响所有新打开的终端窗口中的 python 命令】
第六步：验证结果python --version
输出应为 Python 3.12.4；再执行 which python，路径应类似 /Users/xxx/.pyenv/versions/3.12.4/bin/python
用 alias 快速覆盖 python 命令（轻量级）
适合只用一个新版Python、不打算管理多个版本的用户，操作快、无依赖，但无法按项目切换。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
方法一：直接绑定 python3 可执行文件路径
先查路径：which python3
常见输出如 /opt/homebrew/bin/python3 或 /usr/local/bin/python3
编辑 ~/.zshrc，在末尾添加一行：alias python=/opt/homebrew/bin/python3
注意：等号前后不能有空格，路径必须准确。
方法二：同时绑定 pip（避免后续 pip 安装到旧环境）
在同一行下方追加：alias pip=/opt/homebrew/bin/pip3
执行 source ~/.zshrc 生效。
⚠️ 提醒：如果之后卸载了 Homebrew Python，这个 alias 会失效且报 command not found，需手动删掉对应行。
修改 PATH 优先级（底层生效）
让 shell 在查找命令时，优先匹配你指定目录下的 python，而非系统路径里的旧版本。
第一步：确认目标 Python 的 bin 目录位置
比如你通过官网安装包装的 Python 3.12，路径通常是：/Library/Frameworks/Python.framework/Versions/3.12/bin
第二步：在 ~/.zshrc 最顶部（不是末尾）添加：export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"
【顺序不能颠倒，$PATH 必须放在后面，否则系统路径仍优先】
第三步：重载配置source ~/.zshrc
第四步：验证echo $PATH 应看到你刚加的路径排在最前；python --version 应返回 3.12.x
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
