当前位置:主页 > python教程 >

pyenv命令管理多个Python版本

发布:2022-09-12 09:43:06 149


为找教程的网友们整理了Python相关的编程文章,网友郭飞羽根据主题投稿了本篇教程内容,涉及到pyenv、切换python版本、python、pyenv、pyenv、离线安装python相关内容,已被405网友关注,如果对知识点想更进一步了解可以在下方电子资料中获取。

从接触Python以来,一直都是采用 virtualenv 和 virtualenvwrapper 来管理不同项目的依赖环境,通过 workon 、 mkvirtualenv 等命令进行虚拟环境切换,很是愉快。

然而,最近想让项目能兼容更多的Python版本,例如至少同时兼容 Python2.7 和 Python3.3+ ,就发现采用之前的方式行不通了。

最大的问题在于,在本地计算机同时安装 Python2.7 和 Python3 后,即使分别针对两个Python版本安装了 virtualenv 和 virtualenvwrapper ,也无法让两个Python版本的 workon 、 mkvirtualenv 命令同时生效。另外一方面,要想在本地计算机安装多个Python版本,会发现安装的成本都比较高,实现方式也不够优雅。

幸运地是,针对该痛点,已经存在一个比较成熟的方案,那就是 pyenv 。

如下是官方的介绍。

pyenv lets you easily switch between multiple versions of Python. It's simple, unobtrusive, and follows the UNIX tradition of single-purpose tools that do one thing well.

This project was forked from rbenv and ruby-build , and modified for Python.

本文就针对 pyenv 最核心的功能进行介绍。

基本原理

如果要讲解 pyenv 的工作原理,基本上采用一句话就可以概括,那就是:修改系统环境变量 PATH 。

对于系统环境变量 PATH ,相信大家都不陌生,里面包含了一串由冒号分隔的路径,例如 /usr/local/bin:/usr/bin:/bin 。每当在系统中执行一个命令时,例如 python 或 pip ,操作系统就会在 PATH 的所有路径中从左至右依次寻找对应的命令。因为是依次寻找,因此排在左边的路径具有更高的优先级。

而 pyenv 做的,就是在 PATH 最前面插入一个 $(pyenv root)/shims 目录。这样, pyenv 就可以通过控制 shims 目录中的Python版本号,来灵活地切换至我们所需的Python版本。

如果还想了解更多细节,可以查看 pyenv 的文档介绍及其源码实现。

环境初始化

pyenv 的安装方式包括多种,重点推荐采用 pyenv-installer 的方式,原因主要有两点:

通过 pyenv-installer 可一键安装 pyenv 全家桶,后续也可以很方便地实现一键升级;
pyenv-installer 的安装方式基于 GitHub ,可保证总是使用到最新版本的 pyenv ,并且 Python 版本库也是最新最全的。
install && config

通过如下命令安装 pyenv 全家桶。

$ curl -L https://raw.githubusercontent.com/pyenv/pyenv-installer/master/bin/pyenv-installer | bash

内容除了包含 pyenv 以外,还包含如下插件:

  1. pyenv-doctor
  2. pyenv-installer
  3. pyenv-update
  4. pyenv-virtualenv
  5. pyenv-which-ext

安装完成后, pyenv 命令还没有加进系统的环境变量,需要将如下内容加到 ~/.zshrc 中,然后执行 source ~/.zshrc 。

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

完成以上操作后, pyenv 就安装完成了。

$ pyenv -v
pyenv 1.0.8

如果不确定 pyenv 的环境是否安装正常,可以通过 pyenv doctor 命令对环境进行检测。

$ pyenv doctor
Cloning /Users/Leo/.pyenv/plugins/pyenv-doctor/bin/.....
Installing python-pyenv-doctor...

BUILD FAILED (OS X 10.12.3 using python-build 20160602)

Last 10 log lines:
checking for memory.h... yes
checking for strings.h... yes
checking for inttypes.h... yes
checking for stdint.h... yes
checking for unistd.h... yes
checking openssl/ssl.h usability... no
checking openssl/ssl.h presence... no
checking for openssl/ssl.h... no
configure: error: OpenSSL development header is not installed.
make: *** No targets specified and no makefile found. Stop.
Problem(s) detected while checking system.

通过检测,可以发现本地环境可能存在的问题,例如,从以上输出可以看出,本地的 OpenSSL development header 还没有安装。根据提示的问题,逐一进行修复,直到检测不再出现问题为止。

update

通过 pyenv update 命令,可以更新 pyenv 全家桶的所有内容。

$ pyenv update
Updating /Users/Leo/.pyenv...
From https://github.com/yyuu/pyenv
 * branch      master   -> FETCH_HEAD
Already up-to-date.
Updating /Users/Leo/.pyenv/plugins/pyenv-doctor...
From https://github.com/yyuu/pyenv-doctor
 * branch      master   -> FETCH_HEAD
Already up-to-date.
Updating /Users/Leo/.pyenv/plugins/pyenv-installer...
From https://github.com/yyuu/pyenv-installer
 * branch      master   -> FETCH_HEAD
Already up-to-date.
Updating /Users/Leo/.pyenv/plugins/pyenv-update...
From https://github.com/yyuu/pyenv-update
 * branch      master   -> FETCH_HEAD
Already up-to-date.
Updating /Users/Leo/.pyenv/plugins/pyenv-virtualenv...
From https://github.com/yyuu/pyenv-virtualenv
 * branch      master   -> FETCH_HEAD
Already up-to-date.
Updating /Users/Leo/.pyenv/plugins/pyenv-which-ext...
From https://github.com/yyuu/pyenv-which-ext
 * branch      master   -> FETCH_HEAD
Already up-to-date.

pyenv的核心使用方法

pyenv 的主要功能如下:

$ pyenv -h
Usage: pyenv <command> [<args>]

Some useful pyenv commands are:
   commands    List all available pyenv commands
   local       Set or show the local application-specific Python version
   global      Set or show the global Python version
   shell       Set or show the shell-specific Python version
   install     Install a Python version using python-build
   uninstall   Uninstall a specific Python version
   rehash      Rehash pyenv shims (run this after installing executables)
   version     Show the current Python version and its origin
   versions    List all Python versions available to pyenv
   which       Display the full path to an executable
   whence      List all Python versions that contain the given executable

See `pyenv help <command>' for information on a specific command.
For full documentation, see: https://github.com/yyuu/pyenv#readme

查看所有可安装的 Python 版本

$ pyenv install --list
Available versions:
 2.1.3
 ...
 2.7.12
 2.7.13
 ...
 3.5.3
 3.6.0
 3.6-dev
 3.6.1
 3.7-dev

需要注意的是,如果是采用 brew 命令安装的 pyenv ,可能会发现 Python 版本库中没有最新的 Python 版本。所以建议还是通过 GitHub 源码方式安装 pyenv 。

安装指定版本的 Python 环境

$ pyenv install 3.6.0
Downloading Python-3.6.0.tar.xz...
-> https://www.python.org/ftp/python/3.6.0/Python-3.6.0.tar.xz
Installing Python-3.6.0...
Installed Python-3.6.0 to /Users/Leo/.pyenv/versions/3.6.0

查看当前系统中所有可用的 Python 版本

$ pyenv versions
* system (set by /Users/Leo/.pyenv/version)
 2.7.13
 3.6.0

切换 Python 版本

pyenv 可以从三个维度来管理 Python 环境,简称为: 当前系统 、 当前目录 、 当前shell 。这三个维度的优先级从左到右依次升高,即 当前系统 的优先级最低、 当前shell 的优先级最高。

如果想修改系统全局的Python环境,可以采用 pyenv global PYTHON_VERSION 命令。该命令执行后会在 $(pyenv root) 目录(默认为 ~/.pyenv )中创建一个名为 version 的文件(如果该文件已存在,则修改该文件的内容),里面记录着系统全局的Python版本号。

$ pyenv global 2.7.13
$ cat ~/.pyenv/version
2.7.13
$ pyenv version
2.7.13 (set by /Users/Leo/.pyenv/version)

$ pyenv global 3.6.0
$ cat ~/.pyenv/version
3.6.0
$ pyenv version
3.6.0 (set by /Users/Leo/.pyenv/version)

通常情况下,对于特定的项目,我们可能需要切换不同的Python环境,这个时候就可以通过 pyenv local PYTHON_VERSION 命令来修改 当前目录 的Python环境。命令执行后,会在当前目录中生成一个 .python-version 文件(如果该文件已存在,则修改该文件的内容),里面记录着当前目录使用的Python版本号。

$ cat ~/.pyenv/version
2.7.13
$ pyenv local 3.6.0
$ cat .python-version
3.6.0
$ cat ~/.pyenv/version
2.7.13
$ pyenv version
3.6.0 (set by /Users/Leo/MyProjects/.python-version)
$ pip -V
pip 9.0.1 from /Users/Leo/.pyenv/versions/3.6.0/lib/python3.6/site-packages (python 3.6)

可以看出,当前目录中的 .python-version 配置优先于系统全局的 ~/.pyenv/version 配置。

另外一种情况,通过执行 pyenv shell PYTHON_VERSION 命令,可以修改 当前shell 的Python环境。执行该命令后,会在当前 shell session (Terminal窗口)中创建一个名为 PYENV_VERSION 的环境变量,然后在 当前shell 的任意目录中都会采用该环境变量设定的Python版本。此时, 当前系统 和 当前目录 中设定的Python版本均会被忽略。

$ echo $PYENV_VERSION

$ pyenv shell 3.6.0
$ echo $PYENV_VERSION
3.6.0
$ cat .python-version
2.7.13
$ pyenv version
3.6.0 (set by PYENV_VERSION environment variable)

顾名思义, 当前shell 的Python环境仅在当前shell中生效,重新打开一个新的shell后,该环境也就失效了。如果想在 当前shell 中取消shell级别的Python环境,采用 unset 命令重置 PYENV_VERSION 环境变量即可。

$ cat .python-version
2.7.13
$ pyenv version
3.6.0 (set by PYENV_VERSION environment variable)

$ unset PYENV_VERSION
$ pyenv version
2.7.13 (set by /Users/Leo/MyProjects/.python-version)

管理多个依赖库环境

经过以上操作,我们在本地计算机中就可以安装多个版本的 Python 运行环境,并可以按照实际需求进行灵活地切换。然而,很多时候在同一个 Python 版本下,我们仍然希望能根据项目进行环境分离,就跟之前我们使用 virtualenv 一样。

在 pyenv 中,也包含这么一个插件, pyenv-virtualenv ,可以实现同样的功能。

使用方式如下:

$ pyenv virtualenv PYTHON_VERSION PROJECT_NAME

其中, PYTHON_VERSION 是具体的Python版本号,例如, 3.6.0 , PROJECT_NAME 是我们自定义的项目名称。比较好的实践方式是,在 PROJECT_NAME 也带上Python的版本号,以便于识别。

现假设我们有 XDiff 这么一个项目,想针对 Python 2.7.13 和 Python 3.6.0 分别创建一个虚拟环境,那就可以依次执行如下命令。

$ pyenv virtualenv 3.6.0 py36_XDiff
$ pyenv virtualenv 2.7.13 py27_XDiff

创建完成后,通过执行 pyenv virtualenvs 命令,就可以看到本地所有的项目环境。

$ pyenv virtualenvs
 2.7.13/envs/py27_XDiff (created from /Users/Leo/.pyenv/versions/2.7.13)
* 3.6.0/envs/py36_XDiff (created from /Users/Leo/.pyenv/versions/3.6.0)
 py27_XDiff (created from /Users/Leo/.pyenv/versions/2.7.13)
 py36_XDiff (created from /Users/Leo/.pyenv/versions/3.6.0)

通过这种方式,在同一个Python版本下我们也可以创建多个虚拟环境,然后在各个虚拟环境中分别维护依赖库环境。

例如, py36_XDiff 虚拟环境位于 /Users/Leo/.pyenv/versions/3.6.0/envs 目录下,而其依赖库位于 /Users/Leo/.pyenv/versions/3.6.0/lib/python3.6/site-packages 中。

$ pip -V
pip 9.0.1 from /Users/Leo/.pyenv/versions/3.6.0/lib/python3.6/site-packages (python 3.6)

后续在项目开发过程中,我们就可以通过 pyenv local XXX 或 pyenv activate PROJECT_NAME 命令来切换项目的 Python 环境。

➜ MyProjects pyenv local py27_XDiff
(py27_XDiff) ➜ MyProjects pyenv version
py27_XDiff (set by /Users/Leo/MyProjects/.python-version)
(py27_XDiff) ➜ MyProjects python -V
Python 2.7.13
(py27_XDiff) ➜ MyProjects pip -V
pip 9.0.1 from /Users/Leo/.pyenv/versions/2.7.13/envs/py27_XDiff/lib/python2.7/site-packages (python 2.7)

可以看出,切换环境后, pip 命令对应的目录也随之改变,即始终对应着当前的Python虚拟环境。

对应的,采用 pyenv deactivate 命令退出当前项目的 Python 虚拟环境。

如果想移除某个项目环境,可以通过如下命令实现。

$ pyenv uninstall PROJECT_NAME

以上便是日常开发工作中常用的 pyenv 命令,基本可以满足绝大多数依赖库环境管理方面的需求。


参考资料

相关文章

  • Python机器学习降低静态日志噪声实例方法

    发布:2019-06-23

    今天小编就为大家分享一篇关于使用Python和机器学习的静态日志噪声的文章,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧


  • Python3.7中安装openCV库的实例讲解

    发布:2020-02-03

    这篇文章主要介绍了Python3.7中安装openCV库的方法,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下


  • Python多线程实例详解

    发布:2020-01-11

    这篇文章主要介绍了Python 多线程实例详解的相关资料,需要的朋友可以参考下


  • python怎么解压rar文件

    发布:2021-05-06

    Python要解压rar类型压缩文件需要安装rarfile包,在网上下载包然后解压到Python安装文件夹下的scripts文件夹下,在当前目录下打开cmd输入命令安装即可,然后就可以在Python中解压rar文件了。


  • pycharm的Python console不能调试当前程序的解决方案

    发布:2020-02-16

    今天小编就为大家分享一篇解决pycharm的Python console不能调试当前程序的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧


  • Python用MyQR制作动态彩色二维码实例

    发布:2019-11-22

    MyQR是一个能够生成自定义二维码的第三方库,你可以根据需要生成普通二维码、带图片的艺术二维码,也可以生成动态二维码。这篇文章主要介绍了Python使用MyQR制作专属动态彩色二维码,需要的


  • 关于Python开发SQLite3数据库相关操作实例详解【连接,查询,插入,更新,删除,关闭等】

    发布:2020-01-15

    这篇文章主要介绍了Python开发SQLite3数据库相关操作,结合实例形式较为详细的分析了Python操作SQLite3数据库的连接,查询,插入,更新,删除,关闭等相关操作技巧,需要的朋友可以参考下


  • Python3用SMTP协议发送E-mail电子邮件的实例方法

    发布:2019-12-08

    SMTP(Simple Mail Transfer Protocol)即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。下面这篇文章主要给大家介绍了关于Python3如何利用SMTP协议发


  • 《Python编程:从入门到实践》学习笔记

    发布:2018-12-01

    1、.title() 每个单词首字母大写 .upper() 所有字母大写 .lower() 所有字母小写 2、 t 空白 转义字符只能用在内 n 换行 3、.rstrip() 删除末尾空白 .lstrip() 删除开头空白 .strip() 删除两端空白 4、Python将带小数点的数都称为浮点数 5、Python的字符串既可以用单引号也可以用双引号 引号内部还有单引号时,只能用 str() 可以将非字符串值表示为字符串 //将23转为23,而不能将abc转为abc Python 用+来合


  • python中while和for的区别点整理

    发布:2020-04-23

    Python中for循环和while循环本质上是没有区别的,但是在实际应用上,针对性不太一样。while循环适用于未知循环次数的循环,for循环适用于已知循环次数的循环 。


网友讨论