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 开发环境。后续只需根据项目需求切换版本，无需担心冲突问题。