Python多版本管理利器:pyenv安装与使用指南

宋时安
宋时安
发布时间:2026-10-12| 3人浏览过
原创

本文详细介绍Python多版本管理工具pyenv的安装与配置方法。通过从GitHub克隆项目、配置环境变量及使用source命令生效,实现pyenv的快速部署。文章涵盖查看可用版本、利用国内镜像加速安装、全局与局部版本切换及卸载等核心操作,帮助开发者轻松解决Python环境冲突问题,提升开发效率。

前言:

在日常项目开发或学习过程中,我们可能需要使用不同的Python版本。众所周知,Python的版本迭代频繁且数量众多。若将所有需要的不同版本Python直接下载到服务器上,管理将变得极其复杂。多版本并存极易相互干扰,一旦处理不当,可能导致服务器Python环境混乱,进而影响正常工作。那么,如何解决Python多版本共存与管理的问题呢?接下来将介绍一款Python环境管理工具:pyenv。借助该工具,你可以轻松在多个版本的Python之间自由切换,彻底告别版本混乱的困扰。

1、安装与配置

pyenv已在GitHub开源,我们可以直接从GitHub克隆项目到本地:

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

随后,依次执行以下命令进行安装:接着向配置文件中追加环境变量(包括pyenv的路径等)

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.profile
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.profile
echo 'eval "$(pyenv init --path)"' >> ~/.profile

完成安装及环境变量配置后,需重新载入配置文件以使追加的配置生效。通常使用source命令,source命令常用于重新执行刚修改的初始化文件,使其立即生效,无需注销并重新登录。具体操作如下所示:

source ~/.bash_profile

若上述过程未报错,则pyenv安装完成。我们可以通过以下命令验证pyenv是否正确安装,并获取pyenv的帮助信息:

pyenv --help

2、使用pyenv

通过pyenv的install命令,我们可以查看pyenv当前支持哪些Python版本,具体如下所示:

pyenv install --list

备注:此处截图并未截全,实际上还有更多的版本。

可以使用pyenv versions命令查看当前系统中包含的Python版本:

pyenv versions

由于我们尚未使用pyenv安装其他Python版本,因此此处仅显示一个系统自带的Python版本。

可以使用pyenv install命令安装不同的Python版本:

pyenv install 3.7.4
pyenv install 3.8.0

此处有一个注意事项:使用pyenv install命令安装Python时,默认从python.org下载指定版本,速度会非常慢,且容易卡在此处:


建议先从国内镜像网站下载指定的Python版本到~/.pyenv/cache目录下,然后再使用pyenv install命令进行安装,这样速度会快很多。此处以淘宝源为例。

wget https://npm.taobao.org/mirrors/python/3.7.4/Python-3.7.4.tar.xz  -P ~/.pyenv/cache

使用国内源下载完成后,再次执行pyenv install命令安装时,会跳过下载步骤,直接进行安装。

安装完成后,再次执行pyenv versions命令,即可看到刚才安装的Python版本。

由于刚才安装了2个Python版本(3.7.4和3.8.0),加上系统自带的Python版本,输出结果中前面的'*'表示当前正在使用的版本。由此可见,目前仍使用的是系统自带的Python版本。

我们可以通过pyenv global更改全局的Python版本,具体操作如下所示:

pyenv global 3.7.4

如果不想让指定的Python版本全局生效,而仅在指定目录下生效,可以使用pyenv local命令进行修改:

pyenv local 3.7.4

此命令仅会使执行该命令的目录下的Python环境发生改变。

如果想要删除Python版本,则使用uninstall命令。具体操作如下所示:

pyenv uninstall 3.7.4

3、总结

使用pyenv后,可以快速切换Python的版本。切换Python版本后,与版本相关的依赖也会随之切换,因此不会造成多版本共存互相干扰的问题。日常开发过程中,使用pyenv install、local、global、uninstall进行Python版本的安装、切换及删除,基本即可满足需求。感兴趣的话,还可以进一步深入了解pyenv的其他使用方式。

到此这篇关于Python多版本管理工具pyenv的文章就介绍到这了,更多相关Python多版本管理工具pyenv内容请搜索本站以前的文章或继续浏览下面的相关文章,希望大家以后多多支持本站!

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。