homebrew 单独安装 python 不支持多版本共存，必须搭配 pyenv；pyenv 依赖 homebrew 安装编译工具链（如 openssl、readline 等），m 系列还需配置 ldflags/cppflags；初始化须用 pyenv init - zsh 并确保 shims 在 path 前置。
直接用 Homebrew 装 Python 本身不支持多版本共存——它只会覆盖 python3 符号链接到最新安装的版本。真要管理多个版本，必须搭配 pyenv，且 Homebrew 只负责装 pyenv 和编译依赖，不碰 Python 解释器本身。
为什么不能只靠 brew install python 多次安装？
Homebrew 的 python 公式（formula）设计就是单版本主导：每次 brew install python 或 brew upgrade python 都会把 /opt/homebrew/bin/python3 指向最新版，并移除旧版二进制。你手动保留多个 python3.11、python3.12 文件也没用——python3 命令始终只有一个指向，且 pip、venv 等工具链不会自动适配不同解释器路径。
- 执行
which python3永远只返回一个路径，比如/opt/homebrew/bin/python3 -
brew unlink python && brew link python@3.11这类操作在新版 Homebrew 中已被弃用，不再可靠 - 系统自带
/usr/bin/python3受 SIP 保护，不能卸载或替换，也不该用于开发
pyenv 安装前必须装齐的编译依赖有哪些？
pyenv install 本质是源码编译，缺任意一个底层库都可能卡在 configure 阶段或报 ssl module not found、readline not available 等错误。M 系列芯片用户尤其容易漏掉 OpenSSL 路径配置。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 通用依赖（Intel/M系列都要装）：
brew install openssl readline sqlite3 xz zlib tcl-tk - M 系列芯片（Apple Silicon）额外两行环境变量必须写入
~/.zshrc：export LDFLAGS="-L/opt/homebrew/opt/zlib/lib -L/opt/homebrew/opt/openssl/lib"export CPPFLAGS="-I/opt/homebrew/opt/zlib/include -I/opt/homebrew/opt/openssl/include" - 装完务必
source ~/.zshrc，否则后续pyenv install 3.14.2很可能因找不到 OpenSSL 头文件失败
pyenv 初始化脚本里 eval "$(pyenv init - zsh)" 和 eval "$(pyenv init -)" 有什么区别？
新版 pyenv（2.4+）明确区分 shell 类型。macOS 默认用 zsh，pyenv init - zsh 输出的是专为 zsh 优化的初始化代码，包含正确的 shell 函数定义和补全逻辑；而 pyenv init - 是旧式通用输出，某些场景下会导致 pyenv shell 不生效或 which python 仍指向系统路径。
- 验证是否生效：运行
pyenv version，应输出类似system (set by /Users/xxx/.pyenv/version)；若报 command not found 或无输出，说明初始化失败 - 常见错误写法：
echo 'eval "$(pyenv init -)"' >> ~/.zshrc—— 缺少zsh参数，新版下大概率失效 - 正确写法（三行缺一不可，顺序也不能错）：
export PYENV_ROOT="$HOME/.pyenv"export PATH="$PYENV_ROOT/bin:$PATH"eval "$(pyenv init - zsh)"
切换版本后 python --version 对了，但 pip --version 显示的还是旧路径？
这是 pyenv shim 机制未完全接管 pip 的典型表现，根本原因通常是：当前 shell 里存在手动 alias、function 或 PATH 中残留了旧 pip 路径。pyenv 的设计是让所有 python、pip、pip3、idle 等命令都通过 ~/.pyenv/shims/ 下的代理脚本路由到对应版本。
- 先运行
which pip，如果输出不是~/.pyenv/shims/pip，说明 shim 没生效 - 检查有没有在
~/.zshrc里写过alias pip=...或function pip() { ... }，删掉 - 运行
pyenv rehash强制重建 shims（尤其在新装一个 Python 版本后） - 确认
~/.pyenv/shims在$PATH最前面：echo $PATH | grep pyenv应该出现在开头附近
真正麻烦的不是装几个版本，而是确保每次打开终端、进入项目目录、执行 pip install 时，shim 层都能稳定拦截并路由——这依赖初始化脚本的完整性、PATH 的纯净性、以及没有其他工具（如 conda、asdf）同时劫持 python 命令。一旦某个环节断开，就容易出现「版本显示对了，但包装到错的地方」这种静默故障。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
