macos 上 python 多版本共存应采用 pyenv + homebrew 组合，通过隔离与按需激活实现版本干净、项目独立、可重现；安装后配置环境变量、编译依赖，再用 pyenv 管理全局/局部/会话版本，并结合 venv 或 direnv 做依赖隔离。

在 macos 上实现 python 多版本共存，核心不是“装多个”，而是“隔离+按需激活”。推荐用 pyenv + homebrew 组合，它不碰系统 python（/usr/bin/python3），也不依赖全局 path 手动切换，真正实现版本干净、项目独立、可重现。

安装 pyenv 并配置基础环境

pyenv 是专为多版本 Python 设计的轻量工具，Homebrew 是最稳妥的安装方式：

• 先确保已装 Homebrew：终端运行 brew -v，无报错即就绪
• 执行 brew install pyenv 安装 pyenv
• 将初始化脚本写入 ~/.zshrc（macOS 默认 shell）：
  • echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
  • echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
  • echo 'eval "$(pyenv init -)"' >> ~/.zshrc
• 运行 source ~/.zshrc 立即生效，再用 pyenv --version 验证

安装编译依赖，避免后续失败

pyenv 安装 Python 版本时需本地编译，缺依赖会卡住或报错。务必提前装好：

• 通用命令：brew install openssl readline sqlite3 xz zlib tcl-tk
• M 系列芯片（Apple Silicon）额外执行：
  • 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

安装与切换 Python 版本

版本管理分三层：全局默认、项目局部、临时会话。全部由 pyenv 自动路由，无需改 PATH：

testing-python

使用pytest编写和评估有效的Python测试。适用于编写测试、审查测试代码、调试测试失败或提高测试覆盖率。

下载

• 查看可用版本：pyenv install --list | grep "^\s*[0-9]"（过滤出稳定版）
• 安装常用版本，例如：pyenv install 3.11.9 3.12.5 3.13.3（每版约 2–5 分钟）
• 设全局默认：pyenv global 3.12.5 → 所有新终端都用此版本
• 进项目目录后设局部版本：cd myproject && pyenv local 3.9.18 → 自动生成 .python-version 文件，进出自动切换
• 验证当前解释器：python --version 和 which python（应显示 ~/.pyenv/shims/python）

配合虚拟环境做依赖隔离

只管解释器版本还不够——同一 Python 版本下，不同项目也必须隔开包。推荐组合方案：

• 创建虚拟环境：python -m venv .venv（自动用当前 pyenv 激活的版本）
• 激活：source .venv/bin/activate → 此时 pip 和 which pip 都指向该环境
• 进阶推荐：direnv + .envrc 实现“进目录自动激活，出目录自动退出”
• 锁定依赖：用 pip-tools（pip-compile 生成带哈希的 requirements.txt）或 poetry（统一管理 pyproject.toml 和虚拟环境）

这套方案已在 2026 年主流开发实践中验证成熟，兼顾安全性、可复现性和日常效率。不复杂但容易忽略细节。

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