在macOS中可通过pyenv实现Python多版本管理：先用Homebrew安装pyenv并配置shell，再安装指定版本（如3.11.9、3.12.5），支持global全局切换和local项目级版本隔离，并自动兼容pip与venv。
如果您在 macOS 系统中需要使用多个 Python 版本进行开发或测试，但系统默认仅提供较旧的 Python 2.7 或未预装 Python 3，则需手动安装并灵活切换版本。以下是完成 Python 环境配置与多版本管理的具体步骤：
一、通过 Homebrew 安装 pyenv 工具
pyenv 是专为 macOS 和类 Unix 系统设计的 Python 版本管理工具，可独立安装、隔离各版本，避免系统 Python 被修改。
1、打开终端，执行命令安装 Homebrew（如尚未安装）：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、运行命令安装 pyenv：brew install pyenv
立即学习“Python免费学习笔记（深入）”；
3、将 pyenv 初始化脚本添加至 shell 配置文件（根据您使用的 shell 选择对应操作）：echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
4、继续追加初始化行：echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"'; echo 'eval "$(pyenv init - zsh)"' >> ~/.zshrc
5、重启终端或执行 source ~/.zshrc 使配置生效。
二、使用 pyenv 安装多个 Python 版本
pyenv 可从源码编译安装指定版本的 Python，所有安装路径均受控于 pyenv，不干扰系统环境。
1、查看当前可安装的 Python 版本列表：pyenv install --list | grep "^[0-9]" | grep -E "\.(0|1|2|3|4|5|6|7|8|9)$"
2、安装 Python 3.11.9：pyenv install 3.11.9
3、安装 Python 3.12.5：pyenv install 3.12.5
4、安装完成后，列出所有已安装版本：pyenv versions
5、确认当前激活版本（显示带 * 号的条目）：pyenv version
三、全局切换默认 Python 版本
设置全局 Python 版本会影响所有新打开的终端会话中的 python 命令指向，适用于长期以某版本为主开发的场景。
1、将默认 Python 设为 3.11.9：pyenv global 3.11.9
2、验证变更是否生效：python --version
3、若需还原为系统自带版本（如有），执行：pyenv global system
4、注意：执行后需新开终端窗口才能确保 PATH 正确加载对应版本的 bin 目录。
四、为特定项目设置局部 Python 版本
在项目根目录下创建 .python-version 文件，pyenv 将自动识别并在进入该目录时切换至指定版本，实现项目级环境隔离。
1、进入目标项目目录：cd /path/to/your/project
2、设置本目录专用 Python 版本：pyenv local 3.12.5
3、该命令会在当前目录生成 .python-version 文件，内容即为 3.12.5
4、离开该目录后，终端自动恢复上一级设定（如 global 或其他 local）；再次进入即刻启用 3.12.5。
五、验证 pip 及虚拟环境兼容性
每个由 pyenv 安装的 Python 版本均自带独立 pip，且支持标准 venv 模块，无需额外安装 virtualenv。
1、检查当前 pip 版本是否匹配 Python 版本：pip --version
2、创建基于当前 Python 版本的虚拟环境：python -m venv myenv
3、激活虚拟环境：source myenv/bin/activate
4、激活后提示符前缀应显示环境名，且 which python 返回路径包含 myenv/bin/python。
