brew install python 仅安装最新版且无法多版本共存，必须用 pyenv 管理；pyenv 安装需先装齐 openssl、readline、sqlite3 等依赖，并正确初始化 ~/.zshrc；安装后须执行 pyenv global 或 local 设置生效版本。
brew install python 装出来的只是最新版 Python，不能直接管理多个版本。Homebrew 本身不支持像 pyenv 那样自由切换 3.9/3.11/3.12 等共存版本——它只能通过 python@3.11 这类公式安装旧版，但每次只能 link 一个到 python3，且容易冲突、维护成本高。真要多版本并存，必须上 pyenv。
为什么不能只靠 brew install python@3.x？
Homebrew 的 python@3.11、python@3.12 是独立 formula，装完默认不会注册进全局命令链：
-
brew install python@3.11后，python3 --version仍显示你之前 link 的版本（通常是最新版） - 手动
brew unlink python && brew link python@3.11可强制切换，但一旦执行brew upgrade，它可能自动回退到最新版，导致环境突变 - 无法为不同项目绑定不同 Python 版本（比如 A 项目用 3.11.9，B 项目用 3.12.5）
- 没有虚拟环境隔离能力，
pip install全局污染风险仍在
pyenv 安装前必须装齐的依赖库
pyenv install 3.11.9 卡在 configure 或报 No module named _ssl / _sqlite3 not found，90% 是缺编译依赖。不是 Homebrew 装了就完事，得显式装全：
- 先确认 Xcode 命令行工具已装：
xcode-select --install（弹窗点安装，别跳过） - 再一次性装齐底层库：
brew install openssl readline sqlite3 xz zlib - Apple Silicon（M1/M2/M3）用户额外加装：
brew install tcl-tk（避免 tkinter 缺失）
pyenv 初始化必须写对三行，漏一行就失效
macOS 默认 shell 是 zsh，初始化脚本必须完整追加到 ~/.zshrc，顺序和内容都不能错：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrcecho 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc-
echo 'eval "$(pyenv init - zsh)"' >> ~/.zshrc（注意：不是pyenv init -，末尾必须带zsh）
写完立刻执行：source ~/.zshrc，然后验证：pyenv --version 和 which pyenv 应该返回路径，否则等于白装。
安装后必须设 global 或 local 才生效
pyenv install 3.12.5 成功 ≠ 你就能用 python --version 看到它。新装版本默认是“休眠状态”：
- 设全局默认：
pyenv global 3.12.5（所有终端窗口都用这个） - 设当前目录专用：
pyenv local 3.11.9（会在当前目录生成 .python-version 文件） - 检查当前生效版本：
pyenv version（注意没 s），不是pyenv versions - 如果
python3 --version还是旧的，先运行pyenv rehash刷新 shims
最常被忽略的一点：pyenv 不会动你的系统 /usr/bin/python3，也不会改 pip 行为——它只是把 python 命令重定向到自己管理的版本。所以 pip install 装的包，永远属于当前 pyenv 激活的 Python 实例，不会混。
