macOS 系统自带 Python 3.9（位于 /usr/bin/python），而用户手动安装的 Python 3.12（如从 python.org 下载）默认置于 /Library/Frameworks/ 下并注册为 python3，二者路径、命名与用途分离，导致 python 和 python3 命令指向不同版本。
macos 系统自带 python 3.9（位于 `/usr/bin/python`），而用户手动安装的 python 3.12（如从 python.org 下载）默认置于 `/library/frameworks/` 下并注册为 `python3`，二者路径、命名与用途分离，导致 `python` 和 `python3` 命令指向不同版本。
在 macOS 上观察到 python --version 返回 3.9.6，而 python3 --version 返回 3.12.2，这并非异常，而是系统设计的合理体现。根本原因在于：macOS 自带的 Python 属于系统组件（由 Apple 维护），而用户安装的 Python 是独立第三方发行版。
? 系统 Python vs 用户 Python：定位与职责分明
/usr/bin/python（Python 3.9.6）
这是 macOS Ventura 及后续版本预装的 Python 3.9（具体版本随系统更新略有差异），位于只读系统路径下，受 SIP（System Integrity Protection）保护。它被部分系统脚本或开发工具链依赖，不建议删除或覆盖。/Library/Frameworks/Python.framework/Versions/3.12/bin/python3（Python 3.12.2）
这是你从 python.org 下载 .pkg 安装包后安装的官方 CPython 发行版。其可执行文件默认命名为 python3（而非 python），以明确区分于系统 Python，并避免冲突。你可通过以下命令验证其完整链接结构：
ls -l /Library/Frameworks/Python.framework/Versions/3.12/bin/python*
输出通常类似：
lrwxr-xr-x 1 root admin 8 Mar 15 10:22 /Library/Frameworks/Python.framework/Versions/3.12/bin/python -> python3 -rwxr-xr-x 1 root admin 71248 Mar 15 10:22 /Library/Frameworks/Python.framework/Versions/3.12/bin/python3 -rwxr-xr-x 1 root admin 71248 Mar 15 10:22 /Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12
可见，python 在此目录下实际是 python3 的符号链接——但该链接仅在此目录内有效；由于该路径未被优先加入 PATH，终端调用 python 时仍会命中 /usr/bin/python。
⚠️ 不推荐的手动覆盖方案（风险提示）
有建议通过创建全局符号链接强制 python 指向新版，例如：
立即学习“Python免费学习笔记（深入）”；
sudo ln -sf /Library/Frameworks/Python.framework/Versions/3.12/bin/python3 /usr/local/bin/python
⚠️ 强烈不推荐此做法：
- /usr/local/bin 虽常在 PATH 前置位，但需 sudo 权限，违背最小权限原则；
- 一旦覆盖，可能破坏依赖系统 Python 的 Homebrew 公式、Xcode 工具链或 IDE 内置功能；
- 多项目协作时易引发不可复现的环境问题。
✅ 推荐实践：用 venv 隔离运行时环境
Python 官方标准库提供的 venv 模块是管理多版本兼容性的黄金标准。它无需额外工具（如 pyenv），零配置即可为每个项目绑定指定解释器：
# 进入项目目录 cd ~/my-project # 基于 Python 3.12 创建虚拟环境（显式指定解释器更可靠） python3.12 -m venv .venv # 激活环境（激活后，python/pip 均指向 3.12） source .venv/bin/activate # 验证 python --version # → Python 3.12.2 which python # → ~/my-project/.venv/bin/python
✅ 优势总结：
- 完全隔离：.venv/ 目录内封装解释器、pip 及所有依赖包；
- 无系统侵入：不影响 /usr/bin/python 或其他用户的环境；
- 显式可控：python3.12 -m venv 清晰表明所用版本，提升项目可复现性；
- IDE 友好：VS Code、PyCharm 等均可自动识别 .venv 并配置解释器。
? 补充建议
- 若需频繁切换默认 python 命令行为（如 CLI 工具开发），可考虑使用 pyenv 管理多版本并设置 shims，但对绝大多数开发者，venv + python3.x 显式调用已足够稳健；
- 永远避免修改 /usr/bin 下任何文件——这是 macOS 系统完整性基石；
- 检查 PATH 顺序：运行 echo $PATH，确认 /Library/Frameworks/.../bin 是否在 /usr/bin 之前（通常不在，故 python 仍走系统路径）。
归根结底，多个 Python 版本共存不是缺陷，而是现代开发环境的常态与优势。理解其背后的设计逻辑（系统稳定性 vs 用户灵活性），并善用 venv 这一轻量、标准、安全的隔离机制，才是 macOS Python 开发的可持续之道。
