使用 pyenv 管理 Python 多版本与虚拟环境

安装 pyenv 与基础配置

pyenv 通过从源代码编译安装 Python，因此需要系统具备相应的编译依赖。对于 Ubuntu/Debian 系统，首先需安装构建工具及必要的库文件：

sudo apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python-openssl

随后，使用官方推荐的脚本安装 pyenv 本体：

curl https://pyenv.run | bash

安装完成后，需将 pyenv 的路径添加到环境变量中，并初始化相关命令。将以下配置追加至 ~/.bashrc 文件：

export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

保存文件后，执行 exec "$SHELL" 使配置立即生效。可通过 pyenv -v 检查安装是否成功，例如输出 pyenv 1.2.12 即表示配置无误。

管理 Python 版本

pyenv 的核心功能是管理多个 Python 解释器。首先，查看当前系统已安装的版本：

pyenv versions

若系统中仅存在系统自带的 Python（如示例中的 2.7.12），可通过 pyenv install -v <version> 命令编译安装指定版本。例如安装 Python 3.7.2：

pyenv install -v 3.7.2

安装完成后，再次运行 pyenv versions 即可看到新安装的版本。此时，全局 Python 版本仍指向系统默认版本。要切换全局版本，使用 pyenv global：

pyenv global 3.7.2

执行后，python -V 将显示切换后的版本。pyenv 支持三种作用域的版本切换，优先级从高到低依次为：shell > local > global。

• 全局切换（global）：影响整个系统，通过 pyenv global <version> 设置。
• 局部切换（local）：仅在当前文件夹及其子目录生效，通过 pyenv local <version> 设置。该命令会在当前目录生成一个 .python-version 文件。
• Shell 切换（shell）：仅在当前终端会话生效，通过 pyenv shell <version> 设置。

创建与管理虚拟环境

除了管理解释器版本，pyenv 还能创建独立的虚拟环境，使不同项目的依赖包互不干扰。创建虚拟环境的命令格式为：

pyenv virtualenv <python_version> <environment_name>

例如，基于 Python 3.7.2 创建一个名为 myprojectenv 的虚拟环境：

pyenv virtualenv 3.7.2 myprojectenv

创建完成后，可在特定项目目录下激活该虚拟环境。进入项目目录（如 ~/workspace/myproject），执行：

pyenv local myprojectenv

此时，该目录下的 Python 和 pip 命令将指向虚拟环境路径。可通过 pyenv which python 和 pyenv which pip 验证路径，例如输出 /root/.pyenv/versions/myprojectenv/bin/python。在虚拟环境中通过 pip 安装的包将仅保存在该虚拟环境目录下，不会影响其他项目或全局环境。

验证与注意事项

完成上述配置后，可通过切换不同目录并运行 python -V 来验证版本切换是否按预期工作。例如，在包含 .python-version 文件的目录中，Python 版本应自动切换至指定版本；而在未配置该文件的目录中，则回退至全局或系统默认版本。

使用 pyenv 时，请注意备份重要数据，尤其是在执行覆盖性或全局性操作前。此外，确保编译依赖完整，以避免安装过程中出现错误。

以上就是使用 pyenv 管理 Python 多版本与虚拟环境的详细内容，更多关于 Python 开发环境配置的资料请关注本站其它相关文章！