5分鐘 Pipenv 上手指南

Python之禪發表於2018-12-18

640?wx_fmt=jpeg

題圖：Photo by Nina Ž. on Unsplash

你可能聽說過 Pipenv，如果還沒有使用，那麼恭喜你，這個工具可以讓你的開發工作省心不少。同一時間段內我們有可能負責多個專案的開發，保證每個專案的環境獨立，互不影響非常有必要的，virtualenv  就是幹這個事的，Pip 主要負責安裝第三方包，而 Pipenv 就是兩者的結合體，給我們的開發帶來了更多的便利性。 所有的命令都可以通過 pipenv 完成。

現在就花5分鐘，掌握這個工具的使用吧。

安裝 Pipenv

pipenv 的安裝和普通的第三方庫沒什麼區別，可以直接使用 pip 命令安裝。

pip install  pipenv
`

在 Mac 上可以使用 brew 命令來安裝

brew install pipenv

接下來介紹如何使用 Pipenv，我們開啟新專案後，首先要做的就是為其單獨建立一個虛擬環境（確保你的電腦裡面只安裝一個Python版本，否則總會出現不可預知的問題）

建立虛擬環境

虛擬環境是每個專案獨立使用的 Python 執行環境。

# 進入專案所在目錄
cd your_project

pipenv install

嚴格來說，pipenv 沒有直接提供建立虛擬環境的命令，而是在背後默默幫你建立，install 其實是安裝第三方包的命令，對新專案來說，它會先建立虛擬環境，同時，在專案目錄下建立名為 Pipfile 的空檔案。

虛擬環境的名字和專案名相關，預設情況下，Pipenv 會自動為你選擇虛擬環境的儲存位置，在 Windows 下通常為 C:\Users\.virtualenvs

安裝第三方包

以前安裝包使用 pip 命令，現在你可以用 pipenv 命令來安裝，例如我安裝 requests 包：

pipenv install requests

使用 pipenv 安裝第三方包有什麼好處呢？安裝前你不需要啟用虛擬環境，就直接下載到了虛擬環境中，如果用 pip 安裝，你還要先啟用該環境。（我經常忘記給虛擬環境取了什麼名字）

安裝完包之後，Pipfile 檔案會被更新，同時新增了 Pipfile.lock 檔案

Pipfile 檔案中的結構：

[[source]]
name = "pypi"
url = "https://pypi.org/simple"
verify_ssl = true

[dev-packages]

[packages]
requests = "*"

[requires]
python_version = "3.7"

Pipfile 檔案中記錄了3件事情：

  1. 包從哪裡下載的

  2. 需要下載哪些包， * 表示始終下載最新版本，  dev-packages 表示專用於開發階段使用的包。

  3. Python 版本是多少

Pipfile.lock 檔案詳細記錄了這些包的資訊，包括這個包的hash值多少，還有包所依賴的其他包有哪些。

把這些資訊寫在 Pipfile 檔案中的好處是，當我們把專案部署到正式環境時，不再需要一個一個去安裝了，直接執行 pipenv install 就會自動建立虛擬環境的同時，把 Pipfile 中包都安裝好。

啟用虛擬環境

執行程式前我們還是要啟用虛擬環境，我們可以使用 pipenv shell 來啟用，不需要指定名字，只要你在當前專案下執行該命令就行。

pipenv shell

Launching subshell in virtual environment…
Microsoft Windows [Version 10.0.18290.1000]
(c) 2018 Microsoft Corporation. All rights reserved.

(weihub-flask-j3rUnHkH) D:\my\weihub-flask>

注意到了嗎？ 目錄前面多了一對括號括起來的字串，它就是我們剛剛建立的虛擬環境名字。 啟用虛擬環境後，你就可以開始執行你的程式了。

(weihub-flask-j3rUnHkH) D:\my\weihub-flask> python

>>> import requests
>>> requests.get("http://baidu.com").text
'<html>\n<meta http-equiv="refresh" content="0;url=http://www.baidu.com/">\n</html>\n'
>>>

退出虛擬環境使用 exit 命令， 這時候那對括號就消失了。

pipenv run

另外，pipenv 還準備了一個 run 命令，它可以在你不必顯示啟用虛擬環境的情況下，用虛擬環境執行命令，例如：

pipenv run python -m http.server
pipenv run python main.py

以上就是你要掌握的 Pipenv 基礎知識，如果有興趣，你還可以瞭解下面的內容

從 requirements.txt 匯入

如果是老專案，你把依賴包全部放在 requirements.txt 中，pipenv 很貼心，它支援從 requirements.txt 檔案中安裝，方便使用 pip 的使用者平滑遷移過來。

pipenv install -r requirements.txt

只安裝到開發環境

在開發環境下我們要安裝 django-debug-toolbar， pytest 這樣的包，這些在生產環境其實是用不上的，所以沒必要安裝，那麼我們在安裝某個包的時候可以在 isntall 後面加個引數 —dev，表示只安裝在開發環境，例如：

pipenv install pytest --dev

在生產環境執行：

# 生產環境
pipenv install

開發環境執行：

# 開發環境
pipenv install --dev

解除安裝包

pipenv uninstall requests

刪除虛擬環境

pipenv --rm

刪除虛擬環境後，會把虛擬環境目錄和裡面的所有依賴包刪除掉，但是 Pipfile 和 Pipfile.lock 檔案還會保留。

常見問題：

如果你在使用 pipenv 建立虛擬環境失敗了，出現類似這樣的錯誤：

pipenv install
Creating a virtualenv for this project…
Pipfile: D:\my\weihub-flask\Pipfile
Using c:\users\lzjun\appdata\local\programs\python\python37-32\python.exe (3.7.1) to create virtualenv…
[ ===] Creating virtual environment...Already using interpreter c:\users\lzjun\appdata\local\programs\python\python37-32\python.exe
Using base prefix 'c:\\users\\lzjun\\appdata\\local\\programs\\python\\python37-32'
New python executable in C:\Users\lzjun\.virtualenvs\weihub-flask-j3rUnHkH\Scripts\python.exe
ERROR: The executable C:\Users\lzjun\.virtualenvs\weihub-flask-j3rUnHkH\Scripts\python.exe is not functioning
ERROR: It thinks sys.prefix is 'd:\\my\\weihub-flask' (should be 'c:\\users\\lzjun\\.virtualenvs\\weihub-flask-j3runhkh')
ERROR: virtualenv is not compatible with this system or executable
Note: some Windows users have reported this error when they installed Python for "Only this user" or have multiple versions of Python installed. Copying the appropriate PythonXX.dll to the virtualenv Scripts/ directory may fix this problem.

Failed creating virtual environment
[pipenv.exceptions.VirtualenvCreationException]:   File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\cli\command.py", line 254, in install
[pipenv.exceptions.VirtualenvCreationException]:       editable_packages=state.installstate.editables,
[pipenv.exceptions.VirtualenvCreationException]:   File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\core.py", line 1741, in do_install
[pipenv.exceptions.VirtualenvCreationException]:       pypi_mirror=pypi_mirror,
[pipenv.exceptions.VirtualenvCreationException]:   File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\core.py", line 574, in ensure_project
[pipenv.exceptions.VirtualenvCreationException]:       pypi_mirror=pypi_mirror,
[pipenv.exceptions.VirtualenvCreationException]:   File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\core.py", line 506, in ensure_virtualenv
[pipenv.exceptions.VirtualenvCreationException]:       python=python, site_packages=site_packages, pypi_mirror=pypi_mirror
[pipenv.exceptions.VirtualenvCreationException]:   File "c:\users\lzjun\appdata\local\programs\python\python37-32\lib\site-packages\pipenv\core.py", line 935, in do_create_virtualenv
[pipenv.exceptions.VirtualenvCreationException]:       extra=[crayons.blue("{0}".format(c.err)),]
[pipenv.exceptions.VirtualenvCreationException]: Fatal Python error: initfsencoding: unable to load the file system codec
Traceback (most recent call last):
  File "C:\Users\lzjun\.virtualenvs\weihub-flask-j3rUnHkH\lib\encodings\__init__.py", line 31, in <module>
  File "C:\Users\lzjun\.virtualenvs\weihub-flask-j3rUnHkH\lib\codecs.py", line 481
    except UnicodeDecodeError, exc:
                             ^
SyntaxError: invalid syntax

很有可能就是你的系統中安裝多有個版本的Python，可以模糊搜尋 Python*.dll ，把那些不相關的全部刪除，重新試試。

如何提高下載速度

修改 Pipfile 檔案中的URL，將下載源指定為阿里雲或者豆瓣等國內更快的源

[[source]]
name = "pypi"
url = "https://mirrors.aliyun.com/pypi/simple"
#或者使用豆瓣源
url = "http://pypi.douban.com/simple"
verify_ssl = true

Pipenv 有什麼缺點

慢，有時候感覺特別慢，就一直卡在 Locking 過程中，你在安裝的時候跳過 lock 環節，使用命令

pipenv install --skip-lock

更多操作指南，請參考官方文件：
https://pipenv.readthedocs.io/en/latest/basics/

PS：上週的抽獎結果出來了，中獎的有：煌金、見賢思齊、chen、啊哈哈左大神、debugtalk 。謝謝所有讚賞的朋友，沒拿到書的同學繼續努力，好運等著你。

PPS：昨天極客時間有個資料分析的專欄上線，如果你正在學習這塊，或許對你有幫助，但是不要因為便宜就囤起來，需要的時候才去買。另外還有5本週歷，會在這兩天送出。

推薦閱讀：資料分析，Python的另一條高薪轉型之路

640?

相關文章