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，顺序和内容都不能错：

python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、

下载

• echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
• echo '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 实例，不会混。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！