你應該學會的Python多版本管理工具Pyenv

Pyenv

[TOC]

簡介

• 首先，該工具是在類linux環境中的工具，在windows系統下是不支持的。(tips: win10如今支持linux子系統利用WSL,能夠很是方便在windows上使用linux系統，自行google)

• 而後，工具主要做用是解決一個比較棘手的問題，就是多個python版本的使用。不管是pytho2仍是python3包括多個版本之間的使用上。試想下，同一系統環境中，多個項目使用的不一樣的python版本，那麼在啓動項目時，使用的python版本的指定就成了必須明確指定，且不一樣版本所使用的第三方包管理工具的版本也須要明確指定使用。 所以，要解決這種繁瑣的操做，pyenv由此誕生，其就借鑑了Ruby的多版本環境下的管理模式。既然是一種模式，那就套用這種模式。模式設計描述大體以下：

  1. 利用shell啓動加載，初始化工具。
  2. 利用linux系統的三大做用域，system wild/user's home/project_or_instance directory ，也就是 系統做用域(在apphome目錄）/用戶做用域（shell 環境變量）/ 單個項目或者叫實例目錄（目錄下的.python-version文件中描述）/ 。
  3. 一切python及其官方自帶工具或腳本，運行都會隱晦的經過pyenv調用，使用者無感知。原理以下條：
  4. pyenv的命令操做，就是依據三層. 首先是一個環境變量PYENV_VERSION(經過pyenv shell管理它)，優先級第一；而後是每一個app或者project目錄下的.python-version(經過pyenv local管理它，沒有則從當前目錄向上找，直到找到根目錄)。最後是系統層面，就是pyenv_root/version文件，系統層面的文件時放在pyenv安裝目錄的（通常是~/.pyenv/）。若是連version中都沒有，那麼就依據無pipenv狀態下的python執行。
  5. 依據上面規則，依次排查判斷，以此最終肯定本次執行的命令是肯定的python版本。

• 小結： 其實說白了，就是基於path查找命令優先級爲基礎，強行在path前面插入一個pyenv_root/shims的目錄（裏面有僞造的python/pip/setuptools等命令的同名腳本，有興趣能夠看下腳本內容）。而後執行這些僞造命令，其實都是在執行pyenv命令，這些僞造的命令會做爲參數傳遞給pyenv命令，而後執行pyenv命令。而後pyenv命令，根據當前shell所在的上下文（也就是依據三層斷定規則），決定出使用哪一個版本的python和僞造的參數名同名的命令，來具體執行。而python版本須要經過pyenv install安裝到pyenv_root/version/目錄下，這樣才能找到最能匹配的版本。這裏最重要的一點其實就是上下文環境了，根據上下文環境肯定出正確的version版本，這個version版本並且不是某一個肯定的，還能夠是一個優先級順序列表。如： 3.7.0 3.5.6 2.7 ...

博文圖片掛了臨時解決辦法

安裝pyenv

• 前提，只能在類linux系統中使用
• 安裝，執行命令：curl https://pyenv.run | bash
• 配置， 根據提示，在~/.bashrc文件最後，追加如下shell命令：

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

• 斷開shell會話，再鏈接一個，使新添加export命令加載生效。

• 就能夠開始使用pyenv

• 安裝過程參考

經過pyenv安裝python各類發行版

• 首先，pyenv是將現有支持的python各python發行版版本信息保存到pyenv本地的。若是發現沒有本身的版本能夠先經過命令更新本地信息，已達到支持當前版本需求。具體操做參看下面的經常使用命令。
• 而後，經過pyenv install --list|grep 出本身想要的版本。如：pyenv install --list|grep 3.7.0
• 其次，要知道pyenv安裝python也是經過一個叫作pyenv-build的pyenv插件完成的。對pyenv-build感興趣點擊click me, pyenv-build pyenv-build 也是能夠單獨執行使用的命令。
• 再，經過pyenv安裝過程以下： 能夠看到，是從pyenv也是官方網站下載編譯安裝的。warning提示的是懼怕經過pyenv安裝的python會使用提示的文件中的配置，從而影響新安裝的python使用其中的配置，脫離了pyenv對python版本的管理目的。 Tips: 新手要明確一個概念，使用pyenv時是從python發行版的官網新安裝的，和現有系統中的python版本沒有一點關係，當前系統的舊版本依然好好的呆在它原來的位置。有了pyenv，系統有的舊版本被pyenv看成system版原本看待。pyenv安裝的新版本都是放在了~/.pyenv/versions/目錄下的。pyenv根據其設計原理就使用versions目錄下的正確版本了。
• 最後，pyenv安裝python就沒有了神祕感；不過須要注意的是NOTICE:經過pyenv安裝python，仍是要根據不一樣環境須要提早安裝依賴的，安裝依賴查看pyenv安裝python依賴

pyenv命令

參考鏈接

經常使用命令

1. pyenv commands 查看全部子命令
2. pyenv install --list 查看全部可安裝的python發行版
3. 更新可用python發行版,執行命令: cd /root/.pyenv/plugins/python-build/../.. && git pull && cd -
4. pyenv install 3.7.1 安裝指定的發行版，這裏舉例是安裝3.7.1
5. pyenv version 根據上下文，打印出當前環境下使用的python 版本。其中若是打印的是"system (set by /root/.pyenv/version)",表示pyenv沒有獲取到應該使用的版本，就會使用原系統path中的python。
6. pyenv versions 展現當前pyenv可用的python版本，前面有星號的表示當前上下文下會使用的python版本。如圖示：有兩個版本，system表明系統的，非pyenv安裝的版本；而3.7.0就是我經過pyenv install 3.7.0 安裝的版本。
7. pyenv which python3.7 獲取which後面指定的命令的full path，常常用到的自省命令。
8. pyenv whence 2to3 列出指定命令在哪些版本中存在，也是常常用到的自省命令。
9. pyenv local 3.7.0 在當前目錄下，設置當前目錄的使用python版本。設置是記錄在當前目錄下一個.python-version的文件中,該文件由pyenv local 自動生成。 能夠看到操做後，在hello目錄環境下，再執行pyenv version 能夠看出python版本使用的是3.7.0了。先後對比能夠看出pyenv對python版本管理的效果。 除此以外，local後面還能夠設置多個版本，版本間以空格間隔，多個版本間的順序依次下降優先級。也就是如今前面的版本中查找，而後再後面的版本中查找。很是兼容使用tox運行py2和py3雜合的項目。
10. pyenv local --unset 刪除當前目錄下local環境，即刪除了.python-version文件
11. pyenv global 3.7.0 設置3.7.0 爲全局版本，信息寫入到pyenv目錄下的version文件中;若是該命令後沒有跟python發行版本這是返回當前全局版本。
12. pyenv shell 3.7.0 設置當前會話PYENV_VERSION環境變量爲3.7.0；若是不跟版本則打印當前PYENV_VERSION的版本。
13. pyenv uninstall version 卸載某個版本的python
14. pyenv rehash 安裝新版本後執行，使生效.

多版本Python的管理

使用pyenv就要經過pyenv來安裝python版本了

安裝示例：

• pyenv install 3.7.0
• 新建項目，在項目目錄下設置項目使用的python版本：
  • mkdir new_project
  • cd new_project
  • pyenv local 3.7.0
• 這樣在new_project 目錄下使用python的其餘命令，如pipenv或者pip等都是使用3.7.0版本python對應的版本工具了。
• 再new_project 目錄下使用pip安裝django
  • pip install django
  • pip freeze > requirements.txt 生成requirments.txt文件
• 若是再使用某個命令上有什麼疑問，使用pyenv which +命令名 查看當前環境下使用的命令是否是對應的版本下的。特別是經過pyenv安裝的python3.7 沒有pipenv命令，有時候就使用了system下的，致使使用了錯誤版本非3.7版本的pipenv初始化項目了。因此所使用pyenv which來肯定命令是否使用正確的版本。

小結： 上面也提到了，使用pipenv。其實pyenv + pipenv 的結合使用，是很是棒的一個組合。前者進行python版本管理和切換，後者對python依賴包及獨立虛擬環境的管理。具體pipenv的使用介紹查看另外一篇文章。這裏要特別注意，在使用pipenv install 時要指定--python版本與 pyenv version一致，由於pipenv 是不會自動使用pyenv_root/shims中命令的。

Pyenv常見問題Wiki

pyenv-wiki