美文网首页
pyenv 让 python 版本完美切换

pyenv 让 python 版本完美切换

作者: 旭娃 | 来源:发表于2020-08-04 16:58 被阅读0次

    原作地址: jianshu.com/p/3e93311fe6cb

    前言

    我觉得如果使用 python 开发的话,还是在 unix/linux 的环境下吧,shell 工具的效率比 windows 高得多,尽管 windows 下也有 cmder 这种神器,而且现在 windows store 也很好的开发出了 linux 子系统,但是瑕疵非常多,unix/linux 才是完美的环境。本文用到的是 archlinux ,另外 debian/ubuntu、centos 也完全适用。mac 用户也可以参考,不过 homebrew 也提供了非常方便的安装方法,但是建议使用文本做法。

    背景

    python 版本比较多,2 和 3 相差非常大,很多项目需要跑在同一台服务器上,我们可以选择直接运行,也可以选择使用 docker。如果用 docker 那就不需要隔离环境了,如果要直接运行在服务器上,那就必须有隔离环境。比如有的项目使用 python 3.5,有的项目使用 python 3.7,此时我们可以借助 pyenv 帮助我们完美的隔离环境,让多个版本的 python 没有任何冲突,完美共存。

    任务

    使用 pyenv 和 pyenv-virtualenv ,在 linux 下完美隔离 python 各个版本

    第 1 章:使用环境

    操作系统:archlinux

    shell:zsh

    请注意,接下来所有的操作都在 archlinux 下进行,本文不涉及 windows

    清单

    git

    zsh 或者 bash

    pyenv

    pyenv-virtualenv

    1、安装 git

    在各大 linux 的发行版下安装 git 都非常简单,此处只展示部分示例

    archlinux

    sudo pacman -S git

    debian/ubuntu

    sudo apt-get install git

    centos

    sudo yum install git

    2、开启终端

    本文使用 zsh

    3、安装 pyenv

    说明:本文的所有安装都严格遵守官方文档,与官方文档完全保持一致。

    git 地址:https://github.com/pyenv/pyenv

    在你的终端中执行如下命令,安全无毒,请放心食用:

    首先把项目克隆下来,放在家目录下的隐藏文件夹中:.pyenv

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

    然后配置环境变量

    如果你使用 bash,就依次执行如下命令:

    echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc

    echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc

    echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi' >> ~/.bashrc

    如果你使用 zsh,就依次执行如下命令:

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

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

    echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi' >> ~/.zshrc

    echo 命令的含义是:将引号中内容写入某文件中

    请注意,以上的三条 echo 命令的最后一条长长的命令,请你保证它引号中的内容处于 ~/.bashrc 或者 ~/.zshrc 的最底部。

    因为在 pyenv 初始化期间会操作 path 环境变量,导致不可预测的行为。

    查看文件的底部内容,可以使用 tail 命令,用法:tail ~/.bashrc 或者 tail ~/.zshrc,编辑文件可以使用 vim 或者 vscode

    最后,在使用 pyenv 之前,重新初始化 shell 环境,执行如下命令

    exec $SHELL

    不执行该命令也是完全可以的,你可以关闭当前的终端窗口,重新启动一个就可以了。

    此时,你已经完成了 pyenv 的安装了,你使用可以它的全部命令了,但是我建议你先别急着用,一口气装完 pyenv 的一个插件,那就是 pyenv-virtualenv

    4、安装 pyenv-virtualenv

    git 地址:https://github.com/pyenv/pyenv-virtualenv

    把插件克隆在刚才已经安装完毕的 pyenv 的 plugins 文件夹中

    git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv

    然后配置环境变量

    如果你使用 bash,就执行如下命令:

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

    如果你使用 zsh,就执行如下命令:

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

    最后,在使用 pyenv 之前,重新初始化 shell 环境,执行如下命令

    exec $SHELL

    不执行该命令也是完全可以的,你可以关闭当前的终端窗口,重新启动一个就可以了。

    到此,我们的所有重要安装已经全部完成了,可以开始体验了。

    第 2 章:使用 pyenv

    此处仅仅展示 pyenv 和 virtualenv 的日常用法

    检查安装是否正确

    检查 pyenv 的版本

    pyenv version

    查看 pyenv 已经托管了哪些 python 版本

    pyenv versions

    如果你看到了正常的版本信息,就说明可以了,如果看到了类似于 command not found 之类的,就说明安装失败了。

    安装 3.6.6 版本的 python

    pyenv install 3.6.6

    这里有个问题,某些情况下会安装失败,报错就告诉你 Build failed

    这个时候,pyenv 已经在它的 github wiki 里面为我们准备了一篇错误应对方案,原文地址https://github.com/pyenv/pyenv/wiki

    大意如下,只需要执行对应的命令即可:

    archlinux 用户

    sudo pacman -S base-devel openssl zlib

    mac 用户

    brew install openssl readline sqlite3 xz zlib

    Ubuntu/Debian/Mint 用户

    sudo apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev

    CentOS/Fedora <= 21 用户,请你保证已经安装了 xz 工具

    sudo yum install gcc zlib-devel bzip2 bzip2-devel readline-devel sqlite sqlite-devel openssl-devel tk-devel libffi-devel

    Fedora >= 22 用户,请你保证已经安装了 xz 工具

    sudo dnf install -y gcc zlib-devel bzip2 bzip2-devel readline-devel sqlite sqlite-devel openssl-devel tk-devel

    openSUSE 用户

    zypper install gcc automake openssl-devel ncurses-devel readline-devel zlib-devel tk-devel

    Solus 用户

    sudo eopkg it -c system.devel

    sudo eopkg install git gcc make zlib-devel bzip2-devel readline-devel sqlite3-devel openssl-devel tk-devel

    Linuxbrew 用户

    brew install bzip2 openssl readline sqlite xz

    安装完这些补充的工具之后,再次执行:

    pyenv install 3.6.6

    就可以成功了,你可以不断的使用

    pyenv versions

    来查看被 pyenv 托管的 python 版本

    而且你想装什么版本就装什么版本,想装几个装几个,都是完美共存,完美隔离,你可以在终端里输入

    pyenv install

    然后按下 tab 键,就可以看到所有可选的安装版本了

    使用刚才安装的 python 3.6.6

    首先我们需要明确一个概念,pyenv 和 pyenv-virtualenv 他们是如何协作的,你可以这么认为:

    pyenv 托管 python 版本,virtualenv 使用 python 版本

    好了,之前已经装好了版本,那么现在就来使用吧

    第 1 步:创建虚拟环境

    首先需要创建一个虚拟环境,执行命令:

    pyenv virtualenv 3.6.6 my-env

    它的格式就是这样固定的,最后一个是你自己想要的环境的名字,可以随便取。稍等片刻,你将会看到:

    Looking in links: /tmp/tmp0eywgc7v

    Requirement already satisfied: setuptools in /home/joit/.pyenv/versions/3.6.6/envs/my-env/lib/python3.6/site-packages (39.0.1)

    Requirement already satisfied: pip in /home/joit/.pyenv/versions/3.6.6/envs/my-env/lib/python3.6/site-packages (10.0.1)

    类似于这样的回显信息,说明环境已经创建成功了,它还告诉了你,该虚拟环境的绝对路径,如果你进去看了,你就会发现,所谓的虚拟环境,就是把 python 装在 pyenv 的安装目录的某个文件夹中,以供它自己调用。

    第 2 步:激活虚拟环境

    在任意目录下,执行命令:

    pyenv activate my-env

    你会发现,在你的终端里面,多了一个类似于(my-env)这样的一个东西,这时候你如果执行:

    python --version

    那就是 python 3.6.6 了

    如果你执行:

    pip --version

    它会告诉你 pip 包安装的绝对路径,也是 pyenv 安装目录下的某个文件夹

    如果你关掉了终端,那么下次启动你又得重新激活一次了,你可以使用如下命令:

    首先 cd 到某一个目录,比如 ~/test

    cd ~/test

    然后在该目录下执行:

    pyenv local my-env

    你会发现已经被激活了,那么 local 命令和刚才有啥不同呢。如果你执行:

    ls -al

    你就会发现,在 ~/test 目录下,有个隐藏文件 .python-version,你可以看到这个文件里面,只写了一句话 my-env

    这样你只要进入 ~/test 目录,就会自动激活虚拟环境

    在虚拟环境下,你如果直接执行

    python

    就会进入到 python 的交互环境

    如果你写了一个文件,名字叫做 app.py ,里面的内容只有一句代码:print(1)

    然后执行:

    python app.py

    这时候,系统就会调用虚拟环境中的 python 解释器来执行这些代码了

    第 3 章:更新 pyenv

    由于我们是 git 克隆的,所以更新非常简单

    cd ~/.pyenv或者cd $(pyenv root)

    git pull

    第 4 章:卸载 pyenv

    由于 pyenv 把一切都放在 ~/.pyenv 下了,所以卸载很方便,两个步骤就行了

    首先你需要删除环境变量

    然后你需要执行:

    rm -rf ~/.pyenv或者rm -rf $(pyenv root)

    作者:JoiT

    链接:https://www.jianshu.com/p/3e93311fe6cb

    来源:简书

    著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

    相关文章

      网友评论

          本文标题:pyenv 让 python 版本完美切换

          本文链接:https://www.haomeiwen.com/subject/yxilrktx.html