今天小編分享的科技經驗:如何減輕 Python 打包之痛,歡迎閲讀。
本文主要介紹 Python 包管理的問題和解決方法,以及在安裝和運行 Python 時應遵循的策略和步驟。
原文鏈接:https://www.bitecode.dev/p/relieving-your-python-packaging-pain
未經允許,禁止轉載!
作者 | Bite Code 譯者 | 明明如月
責編 | 夏萌
出品 | CSDN(ID:CSDNnews)
随着 Python 3 的普及,Guido 正在致力于提升這門語言的運行速度,而社區中新的抱怨焦點則轉向了包管理。
關于這個話題有很多可以深入探讨的地方,如包的構建、分發及其他諸多問題,但這并不是大部分用户所面臨的困擾。
真正困擾大家的是,他們在嘗試安裝和使用某個包時,往往會遇到預料之外的問題。
本文主要聚焦于幫助你解決這個問題,至少,可以幫你搞定絕大多數情況。
然而,你可能會發現奇怪的現象:你至今為止試過的所有方法都沒有奏效。事實上,大多數關于這個話題的建議可能都無法真正幫助你。
這是因為在 Python 包管理中,絕大部分問題并非直接由包管理本身引起。
問題的症結在于 Python 的啓動問題,也就是如何找到、安裝、配置并運行 Python 的過程。
在過去的 15 年中,我嘗試過所有可能的方法,無論對于專家或是初學者,無論對于專業人士或是業餘愛好者,都沒有找到 " 唯一的正确答案 "。
然而,對大多數人來説,有一種方法會讓失敗的次數少很多。
在這篇文章中,我将列出一系列需要遵循的步驟,并在另一篇新文章中解釋這些步驟的原因。
概述
你只需要遵循下面的 Python 的安裝和運行策略,就可以規避許多包管理方面的問題:
不要急于安裝 Python 的最新版本
在 Windows 和 Mac 上,堅持使用 python.org 的安裝程式,在 Linux 上則使用官方倉庫。
絕對不在虛拟環境之外安裝或運行任何程式
讓自己只使用基礎的命令:pip 和 venv
執行命令時,使用 -m 參數
在創建虛拟環境時,使用命令行參數明确指定 Python 版本
不要盲目追求 Python 的最新版本
對,最新版本的 Python 總是那麼閃亮奪目,性能更強,新功能特性眾多,令人心動。我并不是説你不應該去嘗試它,熟悉它。然而,對于你的項目來説,你最好不要采用這個最新版本。
因此,假設 Python 3.11 是最新的主版本,你最好使用的版本應當是 3.10,或者更舊的版本。如果可能的話(我理解沒有人希望每年都更新 Python 版本),最好将你的版本目标設定在最新主版本的前四個版本,例如在本例中,就應選擇 3.7 版本。
如果你對此有疑問,可以查看 Python 狀态頁。
在這個頁面上,"feature" 指的是當前正在開發的版本,"bugfix" 指的是仍在接收錯誤修復的版本,"security" 指的是仍在接收安全問題修復的版本,而 "end-of-line" 則代表已經停止更新的版本。
在 Windows 和 Mac 上,使用官方安裝器
安裝 Python 的方式有很多種,你選擇何種方式安裝非常關鍵。
是應該使用 Homebrew、Windows 商店,還是使用 Anaconda?答案是都不應該。
你應該直接訪問 python.org,使用他們提供的 Windows 版 Python 安裝器 或 Mac 版安裝器。
如果你想知道為什麼這麼做,可以查閲我寫的 另一篇文章。
如果你想了解安裝的步驟,可以參考我寫的另外一篇專門講解 講解 Python 完整安裝過程的文章。
另外,我知道有些用户因為某些原因必須使用 Anaconda,在文末我将為你解答。
在 Linux 上,使用官方倉庫
請使用你的發行版附帶的官方工具來安裝 Python,可能是 "apt","yum","dnf" 等等。
你将受限于倉庫中的 Python 版本,但要抵制使用 pyenv 來規避這一點的誘惑。
如果恰巧你在使用 Ubuntu,你就很幸運:你可以使用 deadsnake PPA 來增加你可用的版本數。
同樣的,如果你在 Red Hat 上,可以使用 EPEL。
你可能在 Windows/Mac 上開發并在 Linux 上部署。在這種情況下,檢查 Linux 機器上可用的版本,并在 Windows 上安裝相同版本的 Python。
如果以上建議你還聽不太明白,可以查看 與這個主題的完整教程。
安裝軟體包時,堅持使用 pip
請避免使用 conda。
請避免使用 poetry、pipenv、pdm、easy_install。
同樣地,不要使用 pipx。請注意,pipx 和 pip 是兩個完全不同的工具。
不要使用像 apt、yum 等的工具。
如果你對 pip 感到陌生,或不清楚如何使用它,不用擔心,我們将在約兩周後的一篇文章中對此進行詳細講解。
總是在虛拟環境中使用 pip
正因為你正在閲讀這篇文章,也就意味着你可能尚不具備跳過此規則所需要的知識。
因此,千萬别忽視它。
這是最重要的規則。
無論你需要安裝什麼,都應該在虛拟環境中進行。
不論你要安裝的是 black、jupyter、mypy,還是你目前正在考慮的任何軟體包,都應該在虛拟環境中安裝。
最關鍵的是,當你在安裝任何東西時,如果你不确定自己是否在虛拟環境中,你首先要做的就是确認你正處于虛拟環境。
如果你在安裝過程中輸入了 "--user",那麼説明你并未在虛拟環境中安裝。
如果你在輸入 "sudo",你也未在虛拟環境中安裝。
一旦在虛拟環境中安裝了軟體包,為了使用它們,你需要保持在同一環境中。因此,所有的命令,包括運行 pip,都應該在虛拟環境中進行。
如果你對虛拟環境感到陌生,或者不清楚如何使用它,沒關系,我們将在後面的文章中進行詳細解析。
的确,這有點讓人感到困擾。你只是想編程,而不想被這個麻煩的虛拟環境困擾。為什麼它就不能像 cargo 或 npm 那樣簡單呢?
這個問題的答案相當復雜。
但現實情況是,目前你沒有任何可靠的方法可以在沒有虛拟環境的情況下安裝任何東西。
所以你有兩個選擇:不使用虛拟環境,然後遭受各種各樣的問題;或者使用虛拟環境,只需要承受一些小小的麻煩。
只使用 "venv" 來創建虛拟環境
venv 是大部分 Python 安裝包默認附帶的命令,你應該用它來創建新的虛拟環境。
當然,還有一些其他的命令,例如 virtualenv 和 virtualenvwrapper。
你的選擇是:不用它們。
還有一些其他的工具,比如 pipx、pdm、poetry 和 pipenv。
同樣,不用它們。
顯然,anaconda 自帶了 env 子命令。
這個你應該知道:也不要用它。
此刻,那些正在使用這些工具的讀者可能已經開始心潮澎湃。請記住,關于這個話題,我們有另一篇文章。
需要注意的是,venv 是與 python.org 的 Python 安裝器捆綁在一起的,但是在 Linux 上,你可能需要安裝一個特定的包,這将是我們下周要讨論的内容。
在運行 Python 命令時,添加 -m 參數
-m 是 "python" 命令中的一個參數,大部分用户可能并不了解它。但是它可以讓你運行任何可導入的 Python 模塊。由于大多數命令都是 Python 模塊,因此我們可以用這個參數來指示," 運行這個特定的 python 模塊 X"。
不要這樣:
pip install
應該這樣:
python -m pip install
不要這樣:
black
應該這樣:
python -m black
不要這樣:
jupyter notebook
應該這樣:
python -m jupyter notebook
即使你在虛拟環境中,盡管有人可能會告訴你一大堆不一樣的話,你仍然應該這樣做。
的确,這很繁瑣。你只是想寫代碼,不想被這個煩人的 -m 打擾。為什麼它不能像其他工具那樣開箱即用呢?
這個問題説來話長。
但是現在的情況是,你目前沒有任何可靠的方式在不使用 -m 的情況下運行任何 Python 命令。
所以,你有兩個選擇。不使用 -m,受盡困擾。或者使用 -m,只承受一點點困擾。
創建虛拟環境時,要明确所使用的 Python 版本
計算機上存在多個 Python 版本是非常常見的事,而你可能并不清楚這一情況。在創建虛拟環境時,你應該明确聲明要使用哪個 Python 版本,因為這個環境将會永久性地關聯這個特定版本的 Python。
在 Windows 系統中,這意味着使用 py 命令,它是 python.org 的安裝程式所附帶的,并可以通過以下命令列出在你的計算機上所有已安裝的 Python 版本:
py --list-paths
你可能會看到類似于下面的輸出:
-3.9 C:Python39python.exe -3.8 C:Python38python.exe * -3.7 C:Python37python.exe
然後,你可以選擇使用哪個 Python 版本,如:
py -X.Y
例如,想要運行 Python 3.7,可以輸入:
py -3.7>>> print ( 'Hello' ) Hello
在 Linux 和 Mac 系統中,你需要使用帶有版本後綴的 pythonX.Y 命令。
例如,要運行 Python 3.7,可以輸入:
python3.7>>> print ( 'Hello' ) Hello
如果你已經在機器上安裝了 Python,這些指令都可以為你選擇一個已經安裝在你的機器上的 Python 版本并運行。如果你還沒有裝過 Python ,是無法運行的。
請注意,如果你按照以上所有步驟進行操作,那就意味着你會同時使用 venv 和 -m。
因此,在創建虛拟環境時,你可能會輸入一些看起來很復雜的命令。
例如,Windows 系統下的命令為:
"py -3.8 -m venv .venv"
在 Linux 和 Mac 系統下,命令為:
"python3.8 -m venv .venv"
(如果這些對你來説沒有意義,我們會在另一篇文章中進行解釋)
這些命令看起來可能有些復雜,但其實這就是非常正确的做法。
這确實有些麻煩。你可能只是想編寫代碼,而不想處理這些繁瑣的步驟。我們為什麼要寫一些連 Chat GPT 都不推薦的東西呢?
回答這個問題需要長篇大論。
但事實是,目前沒有任何可靠的方法可以在不做這些的情況下創建虛拟環境。
所以你有兩個選擇。一是繼續采用你的原來做法,然後飽受困擾;二是将這段復雜的命令保存在一個檔案中,每次需要時復制粘貼一下,只需飽受一點點困擾。
如果你必須使用 Anaconda,該如何應對?
首先,确保你确實需要使用 Anaconda。我曾經遇到很多人誤以為他們必須使用 Anaconda,然而當他們按照上述步驟進行操作後,他們發現其實并非如此。自從 pypi 引入了 wheel 檔案後,一些過去安裝起來讓人頭疼的包,比如 GUI 工具包(GUI tool-kits)或科學計算相關的包,現在的安裝過程變得輕松許多。
然而,我明白有些人是真的必須使用 Anaconda。
可能你的項目復雜且需要機器學習,或者你的公司的策略就是只使用 Anaconda。
在這種情況下,你依然可以在 Anaconda 的環境中運行。
對于所有操作,只使用 conda,僅僅使用 conda。
不要嘗試使用 pip 或 venv。尤其是,千萬不要嘗試将 conda 與其混合使用。
這樣做雖然會限制你只能使用 Anconda 渠道中的資源,但這是保持工作流程清晰的唯一方式。
對于你應該始終創建虛拟環境并在其中進行所有操作的建議仍然适用,只是這個虛拟環境需要通過 conda 來創建。