macOS Python 多版本管理指南

一、pyenv 安装与配置

pyenv 是轻量级 Python 版本管理工具，支持多版本切换。

安装步骤：

1. 安装 Homebrew（若未安装）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 通过 Homebrew 安装 pyenv：

   brew update
   brew install pyenv
   

3. 配置 shell 环境（以 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 -)"' >> ~/.zshrc
   source ~/.zshrc
   

二、Python 版本管理

# 查看可安装版本
pyenv install --list

# 安装特定版本（如 3.10.6）
pyenv install 3.10.6

# 查看已安装版本
pyenv versions

# 设置全局默认版本
pyenv global 3.10.6

# 设置局部目录版本（进入目录自动切换）
pyenv local 3.9.13

三、虚拟环境配置

推荐使用 pyenv-virtualenv 插件管理虚拟环境：

1. 安装插件：

   brew install pyenv-virtualenv
   echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.zshrc
   source ~/.zshrc
   

2. 创建虚拟环境：

   pyenv virtualenv 3.10.6 myenv-3.10  # 基于指定版本创建
   

3. 激活/停用环境：

   pyenv activate myenv-3.10    # 激活
   pyenv deactivate             # 退出
   

四、pip 镜像加速

国内用户建议配置镜像源提升下载速度：

永久配置（推荐）：

# 创建 pip 配置文件
mkdir -p ~/.pip
cat << EOF > ~/.pip/pip.conf
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

临时使用：

pip install -i https://pypi.doubanio.com/simple package_name

常用镜像源：

• 清华：https://pypi.tuna.tsinghua.edu.cn/simple
• 阿里云：https://mirrors.aliyun.com/pypi/simple/
• 豆瓣：https://pypi.doubanio.com/simple

五、验证环境

# 检查 Python 版本
python --version

# 检查 pip 源配置
pip config list

# 测试虚拟环境
pyenv activate myenv-3.10
python -c "import sys; print(sys.executable)"

最佳实践建议：

1. 使用 pyenv global 设置系统默认版本
2. 为每个项目创建独立虚拟环境
3. 定期更新 pip：pip install --upgrade pip
4. 使用 pip freeze > requirements.txt 管理依赖