脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 脚本专栏 → python → 多版本Python环境管理

多版本Python环境管理方式

 更新时间：2025年07月05日 14:20:43   作者：言之。  
这篇文章主要介绍了多版本Python环境管理方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

Pyenv 是什么？

Pyenv 是一个强大的 Python 版本管理工具，允许你：

  • 在同一台机器上安装多个 Python 版本
  • 轻松切换全局或项目级的 Python 版本
  • 管理虚拟环境（通过 pyenv-virtualenv 插件）
  • 解决不同项目对 Python 版本的依赖问题

安装 Pyenv

1. 安装依赖

# Ubuntu/Debian
sudo apt update
sudo apt install -y make build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

# CentOS/RHEL
sudo yum install gcc zlib-devel bzip2 bzip2-devel readline-devel sqlite \
sqlite-devel openssl-devel xz xz-devel libffi-devel

2. 安装 Pyenv

curl https://pyenv.run | bash

3. 配置 Shell

将以下内容添加到 ~/.bashrc 或 ~/.zshrc：

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

应用配置：

exec "$SHELL"  # 或 source ~/.bashrc / source ~/.zshrc

4. 验证安装

pyenv --version
# 应输出类似: pyenv 2.3.0

管理 Python 版本

1. 查看可安装版本

pyenv install --list

2. 安装 Python 版本

# 安装指定版本
pyenv install 3.8.12
pyenv install 3.9.7

# 安装最新版本
pyenv install 3.10:latest

3. 查看已安装版本

pyenv versions
# 输出示例:
#   system
# * 3.8.12 (set by /home/user/.pyenv/version)
#   3.9.7

4. 设置全局版本

pyenv global 3.9.7

5. 设置临时版本（仅当前会话）

pyenv shell 3.8.12

虚拟环境管理

1. 创建虚拟环境

# 基于当前 Python 版本创建
pyenv virtualenv myenv

# 基于指定 Python 版本创建
pyenv virtualenv 3.8.12 myproject-env

2. 激活/停用环境

# 激活
pyenv activate myproject-env

# 停用
pyenv deactivate

3. 查看所有环境

pyenv virtualenvs

4. 删除环境

pyenv virtualenv-delete myproject-env

5. 自动激活环境（项目级）

cd myproject
pyenv local myproject-env  # 创建 .python-version 文件

项目级 Python 版本控制

1. 设置项目专用版本

cd myproject
pyenv local 3.8.12  # 创建 .python-version 文件

2. 验证版本

python --version
# 应输出: Python 3.8.12

3. 结合虚拟环境使用

cd myproject
pyenv virtualenv 3.8.12 myproject-env
pyenv local myproject-env

高级技巧

1. 加速安装（使用镜像）

# 设置国内镜像（适用于中国用户）
export PYTHON_BUILD_MIRROR_URL="https://npm.taobao.org/mirrors/python/"
pyenv install 3.8.12

2. 自定义编译选项

env PYTHON_CONFIGURE_OPTS="--enable-shared" pyenv install 3.9.7

3. 卸载 Python 版本

pyenv uninstall 3.7.10

4. 更新 Pyenv

pyenv update

常见问题解决

1. 安装时出现 “C compiler cannot create executables”

# 确保已安装所有依赖
sudo apt install build-essential  # Ubuntu/Debian
sudo yum groupinstall "Development Tools"  # CentOS/RHEL

2. 虚拟环境激活后提示符不显示环境名

# 确保在 shell 配置中正确设置了 virtualenv-init
eval "$(pyenv virtualenv-init -)"

3. 安装过程中出现 SSL 错误

# 尝试使用 --patch 选项
pyenv install --patch 3.8.12 < <(curl -sSL https://github.com/python/cpython/commit/8ea6353.patch\?full_index\=1)

4. Python 版本切换无效

# 检查 shell 配置是否正确加载
echo $PATH | grep pyenv
# 应包含 pyenv 路径

# 检查当前目录是否有 .python-version 文件

最佳实践

项目规范：

  • 每个项目使用独立的虚拟环境
  • 在项目根目录创建 .python-version 文件
  • 在 README 中注明 Python 版本要求

版本选择：

  • 新项目使用受支持的稳定版本（如 3.8+）
  • 旧项目保持原有版本不变

依赖管理：

# 在激活虚拟环境后
pip install pip-tools
pip-compile requirements.in > requirements.txt
pip-sync

CI/CD 集成：

# .gitlab-ci.yml 示例
before_script:
  - pyenv install 3.8.12
  - pyenv global 3.8.12
  - python -m venv venv
  - source venv/bin/activate
  - pip install -r requirements.txt

多版本测试：

# 测试脚本示例
for version in 3.7.10 3.8.12 3.9.7; do
  pyenv local $version
  python -m pytest tests/
done

通过本指南，你应该能够：

  • 安装并配置 pyenv
  • 管理多个 Python 版本
  • 创建和使用虚拟环境
  • 为不同项目设置专用 Python 环境
  • 解决常见问题

建议定期运行 pyenv update 保持工具最新，并关注 pyenv GitHub 获取最新动态。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

相关文章

  • python判断图片相似度找出相似的图像问题

    python判断图片相似度找出相似的图像问题

    这篇文章主要介绍了python判断图片相似度找出相似的图像问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2026-03-03
  • Python使用Crypto库实现加密解密的示例详解

    Python使用Crypto库实现加密解密的示例详解

    这篇文章主要为大家详细介绍了Python如何使用Crypto库实现加密解密的功能，文中的示例代码讲解详细，对我们学习Python有一定的帮助，需要的可以参考一下
    2023-01-01
  • python跳出双层循环的方法

    python跳出双层循环的方法

    本文主要介绍了python跳出双层循环的方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2023-01-01
  • Python基于Gensim实现文本相似度/匹配/查重

    Python基于Gensim实现文本相似度/匹配/查重

    Gensim是基于Python语言的自然语言处理库,用来主题建模、文本相似度等文本处理任务,下面我们就来看看如何使用Gensim实现文本相似度/匹配/查重等操作吧
    2024-03-03
  • python中pathlib 面向对象的文件系统路径

    python中pathlib 面向对象的文件系统路径

    文章介绍了Python 3.4+内置的标准库pathlib,该库提供面向对象的文件系统路径处理,通过pathlib,可以更方便地进行路径操作,感兴趣的朋友一起看看吧
    2024-12-12
  • Pandas_cum累积计算和rolling滚动计算的用法详解

    Pandas_cum累积计算和rolling滚动计算的用法详解

    今天小编就为大家分享一篇Pandas_cum累积计算和rolling滚动计算的用法详解，具有好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
    2019-07-07
  • python之如何复制excel模板并保留表格样式

    python之如何复制excel模板并保留表格样式

    这篇文章主要介绍了python之如何复制excel模板并保留表格样式问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2023-06-06
  • Python使用mss获取窗口图片的方法

    Python使用mss获取窗口图片的方法

    Python MSS（Multiple Screen Shots）是一款由BoboTiG开发的开源库,旨在提供高性能、纯Python编写的屏幕截图功能,本文给大家介绍了Python使用mss获取窗口图片的方法,需要的朋友可以参考下
    2025-10-10
  • Python开发中的Nonetype类型详解

    Python开发中的Nonetype类型详解

    这篇文章主要介绍了Python开发中的Nonetype类型详解,None有自己的数据类型NoneType,你可以将None复制给任何变量,但是你不能创建其他NoneType对象,需要的朋友可以参考下
    2023-12-12
  • Python pandas用法最全整理

    Python pandas用法最全整理

    在本篇文章里小编给大家分享的是关于Python pandas用法以及相关实例代码，需要的朋友们可以学习下。
    2019-08-08

最新评论