Pyenv 多版本 Python 环境管理与实战指南
在开发过程中，不同项目往往需要不同的 Python 版本。pyenv 是一个轻量级的版本管理工具，能让我们在同一台机器上轻松切换和管理多个 Python 环境。下面以 Linux 系统为例，介绍从安装到虚拟环境配置的完整流程。
1. 安装 pyenv 核心
首先需要获取 pyenv 源码并配置环境变量。推荐使用 git 克隆到用户主目录。
git clone https://github.com/pyenv/pyenv.git ~/.pyenv
接着将初始化脚本添加到 shell 配置文件中。根据系统不同，配置文件有所区别：
Ubuntu / Debian
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
eval "$(pyenv init -)" >> ~/.bashrc
CentOS 7
echo 'eval "$(pyenv init --path)"' >> ~/.bash_profile
修改完成后，重新加载 shell 配置即可生效：
source ~/.bashrc
exec $SHELL
如果不想立即重启终端，也可以直接关闭当前窗口新建一个会话。
2. 准备编译依赖
编译 Python 解释器需要系统底层的支持库。如果缺少这些依赖，安装过程会报错。
Ubuntu 系统
sudo apt-get install -y build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
注意：较新的 Python 版本（如 3.7+）可能需要 liblzma-dev，否则解压模块可能无法正常工作。
CentOS 7 系统
yum install -y gcc gcc-c++ make zlib-devel bzip2-devel openssl-devel \
ncurses-devel sqlite-devel readline-devel tk-devel gdbm-devel db4-devel \
libpcap-devel xz-devel patch libffi-devel
3. 安装 Python 版本
查看可用版本列表：
pyenv install --list
执行安装命令时加上 -v 参数可以查看详细日志，方便排查问题：
pyenv install 3.7.1 -v
安装完成后，建议运行 rehash 更新命令缓存：
pyenv rehash
4. 设置与切换版本
查看已安装的版本：
pyenv versions
设置全局默认版本：
pyenv global 3.7.1
5. 配置虚拟环境 (pyenv-virtualenv)
为了隔离不同项目的依赖，推荐安装 pyenv-virtualenv 插件。
克隆插件并初始化：
git clone https://github.com/pyenv/pyenv-virtualenv.git ~/.pyenv/plugins/pyenv-virtualenv
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc
source ~/.bashrc
创建虚拟环境：
pyenv virtualenv 3.7.1 env37
常用操作指令：
- 激活：
pyenv activate env37 - 退出：
pyenv deactivate - 列出：
pyenv virtualenvs - 删除：
pyenv virtualenv-delete env37
6. 常见问题与优化
关于 pip 依赖
某些框架（如 PaddleHub）对 setuptools 版本敏感。建议在安装前升级：
pip install --upgrade setuptools
下载速度慢
如果遇到下载源超时，可以先手动下载对应版本的 tar.gz 包放入 ~/.pyenv/cache 目录，再执行安装命令，避免重复拉取。
通过以上步骤，你就拥有了一个灵活可控的 Python 开发环境。后续只需根据项目需求切换版本，无需担心冲突问题。
