核心是不碰系统python、隔离安装、按需切换：先装homebrew并配置openssl等依赖，再用pyenv安装多版本至~/.pyenv/versions/，通过pyenv global/local/shell设置作用域，which python应指向~/.pyenv/shims/python。
在 macos 上配置支持多版本共存的 python 开发环境，核心是**不碰系统 python、隔离安装、按需切换**。苹果自 macos 12.3 起已移除系统级 python 2.7，而系统自带的 python（如 3.8 或 3.9）属于只读受保护组件，直接修改或升级会触发 sip 限制，甚至影响系统功能。因此，必须借助专业工具构建用户级沙箱环境。
安装 Homebrew 并配置基础依赖
Homebrew 是整个方案的地基，它负责安装 pyenv 及其编译所需的核心库。
- 打开终端，运行官方安装命令：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 安装完成后执行 brew doctor，确保无报错；再运行 brew install openssl readline sqlite3 xz zlib tcl-tk
- M 系列芯片（Apple Silicon）用户额外执行两行配置，避免 OpenSSL 链接失败：
echo 'export LDFLAGS="-L/opt/homebrew/opt/zlib/lib -L/opt/homebrew/opt/openssl/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I/opt/homebrew/opt/zlib/include -I/opt/homebrew/opt/openssl/include"' >> ~/.zshrc - 最后执行 source ~/.zshrc 生效
安装并初始化 pyenv
pyenv 是专为 macOS/Linux 设计的 Python 版本管理器，它通过 shell shim 动态拦截 python、pip 等命令，实现零侵入式版本路由。
- 执行 brew install pyenv 安装
- 向 shell 配置写入初始化代码（macOS Catalina 及以后默认用 zsh）：
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 - 运行 source ~/.zshrc 加载配置，再用 pyenv --version 验证是否输出版本号（如 2.4.0）
安装多个 Python 版本并设置作用域
所有版本均编译安装至 ~/.pyenv/versions/，彼此独立，与系统完全隔离。
- 查看可安装列表：pyenv install --list | grep "^[0-9]\+\.[0-9]\+\.[0-9]\+$"（过滤出稳定版）
- 安装常用版本，例如：pyenv install 3.11.9 和 pyenv install 3.13.3（耗时 2–5 分钟，需耐心等待编译完成）
- 执行 pyenv versions 查看已安装版本，带 * 的为当前生效版本
- 按需设置作用域：
全局默认（新终端都用此版本）：pyenv global 3.11.9
当前项目目录专用（进入该目录自动切换）：pyenv local 3.7.17（会在目录下生成 .python-version 文件）
当前终端临时使用：pyenv shell 3.12.5
验证与日常使用要点
每次切换后务必验证，避免误用旧版本或系统 Python。
- 检查当前解释器路径：which python 应返回类似 ~/.pyenv/shims/python，而非 /usr/bin/python 或 /opt/homebrew/bin/python3
- 确认版本：python --version 和 pip --version 输出应一致且匹配预期
- pip 安装的包自动归属当前 pyenv 版本，无需额外创建虚拟环境也能保证隔离；如需更强项目隔离，可在激活某版本后使用 python -m venv .venv
- 若遇到 No module named pip，说明该版本未自带 pip，执行 pyenv rehash 更新 shim 表即可
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
