pyenv 讓 python 版本完美切換


前言

我覺得如果使用 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 下進行,本文不涉及 windows

清單

  1. git
  2. zsh 或者 bash
  3. pyenv
  4. 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' >> ~/.bashrc

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)


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM