Python环境管理指南：pyenv与virtualenv实战详解

简介

pyenv是一款开源的Python版本管理工具，旨在简化系统中多版本Python的安装与切换流程。借助pyenv，用户可以快速安装任意版本的Python，并在不同版本间即时切换，无需再担心系统多版本共存带来的兼容性问题，也省去了手动编译安装的繁琐步骤。只需执行一条命令，即可切换并使用任意已安装的Python版本，真正实现了开箱即用、简单实用的目标。

virtualenv则是用于创建完全隔离的Python虚拟环境的工具，它允许为每个工程项目构建独立的Python运行环境。这一机制有效解决了不同项目对Python包或版本依赖冲突的问题。例如，若项目A运行需要requests库的1.18.4版本，而项目B需要2.18.4版本，在同一系统中直接安装会导致冲突。使用virtualenv为每个项目创建独立的虚拟环境，并分别安装对应版本的依赖包，即可让程序在各自的虚拟环境中运行。这种方式既不影响系统默认的Python环境，又能确保不同版本的Python程序在同一系统中和谐共存。

最佳实践建议：利用pyenv安装任意版本的Python，随后在使用virtualenv创建虚拟环境时，通过指定所需的Python版本路径，即可生成基于特定Python版本的虚拟环境。这种组合使用方式被广泛认为是处理Python环境管理的理想方案。

pyenv的安装及使用

1. 安装

将pyenv克隆至~/.pyenv目录（用户也可选择其他任意路径进行安装）

git clone https://github.com/yyuu/pyenv.git ~/.pyenv

配置环境变量（若使用zsh Shell，请将以下配置添加到~/.zshrc文件中；若使用bash，请添加到~/.bashrc）

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc

添加pyenv初始化配置（若使用zsh Shell，请添加到~/.zshrc；若使用bash，请添加到~/.bashrc）

echo 'eval "$(pyenv init -)"' >> ~/.zshrc

使当前Shell的配置生效，从而完成pyenv的安装过程

exec $SHELL
source ~/.zshrc

2. 使用

查看可供安装的Python版本列表

pyenv install --list

安装指定的Python版本

pyenv install -v 3.6.4

查看当前系统中Python版本的安装情况（*号标记表示当前系统正在使用的Python版本，system表示系统初始版本）

$ pyenv versions
 system
 2.6.7
* 3.6.4 (set by /Users/haohao/.pyenv/version)

切换Python版本（切换完成后，再次查看当前版本以确认更改）

$ pyenv global 3.6.4
$ pyenv versions
 system
* 3.6.4 (set by /Users/haohao/.pyenv/version)
$ python -V
Python 3.6.4

卸载已安装的某个Python版本

pyenv uninstall 3.6.4

virtualenv的安装及使用

1. 安装

sudo pip install virtualenv

2. 使用

接下来，我们将演示如何使用virtualenv创建一个完全隔离的Python虚拟环境：

1. 新建一个目录（通常用作工程项目的根路径）

$ mkdir myproject

2. 进入该目录，创建一个完全独立且干净的虚拟环境

如果在执行virtualenv命令时不添加任何参数，默认创建的虚拟环境将使用系统当前的Python版本。若需创建基于其他版本的虚拟环境，可使用-p参数指定目标Python可执行文件的路径。该可执行文件路径可在上一步通过pyenv安装的~/.pyenv/versions目录下找到，该目录包含了pyenv管理的所有Python版本。

# 使用系统当前的 Python 版本创建虚拟环境
$ virtualenv venv
New python executable in /Users/haohao/PycharmProjects/myproject/venv/bin/python
# 创建虚拟环境时指定 Python 版本
$ virtualenv -p ~/.pyenv/versions/2.6.7/bin/python venv
Running virtualenv with interpreter /Users/haohao/.pyenv/versions/2.6.7/bin/python
New python executable in /Users/haohao/PycharmProjects/myproject/venv/bin/python
Installing setuptools<37, pip, wheel<0.30...done.

3. 激活创建的虚拟环境并开始使用

从输出结果可以看出，当前虚拟环境的Python版本已切换为2.6.7，且所在路径确实指向了上一步创建的虚拟环境目录。此后，通过pip安装的任何包都将自动安装到该虚拟环境的目录中，而不会污染系统标准目录。这确保了当前开发环境的绝对纯净，并对系统环境实现了完全隔离。

$ source venv/bin/activate
$ which python
/Users/haohao/PycharmProjects/myproject/venv/bin/python
$ python -V
Python 2.6.7

4. 退出虚拟环境，恢复至系统默认版本

$ deactivate

以上关于Python两大环境管理神器pyenv和virtualenv的详解内容即为本文分享的全部信息，希望能对广大开发者有所帮助，也欢迎大家继续支持本站。