離線安裝pip：在無網路或受限環境下輕鬆管理Python包
在日常的Python開發和部署工作中，pip作為Python的包管理工具，扮演著至關重要的角色。它使得安裝、升級和管理Python包變得異常便捷。然而，在某些特定的生產環境、安全隔離網路（例如，內網、保密網路或完全離線的「空氣隔離」環境）下，或者當您面臨嚴格的防火牆限制時，直接通過pip從互聯網上下載和安裝包便會成為一個難題。這時，離線安裝pip就成了解決這一困境的關鍵策略。
本文將為您詳細介紹如何在沒有互聯網連接或網路受限的環境中成功安裝pip，並進一步闡述如何利用離線安裝的pip來管理和安裝其他Python包。無論您是系統管理員、開發人員還是需要部署Python應用的任何用戶，這篇指南都將為您提供清晰、可操作的步驟和最佳實踐。
了解pip及其在Python生態中的重要性
pip是Python的官方推薦包管理系統，用於安裝和管理軟體包。它允許用戶從Python包索引（PyPI）或其他索引安裝各種Python庫和應用程序。沒有pip，手動管理複雜的Python項目依賴將是一項艱巨的任務，效率低下且容易出錯。
通常，從Python 3.4版本開始，pip會隨Python解釋器一同安裝。但有時，由於各種原因（例如，自定義Python安裝、舊版本Python、或者在打包和分發過程中剝離了某些組件），您可能需要單獨安裝或更新它。在離線環境下，這尤為常見。
離線安裝pip前的準備工作
在開始離線安裝pip之前，您需要在一個有網路連接的環境中準備好所有必需的文件。這些文件將被轉移到目標離線機器上。
1. 確認Python環境
確保目標離線機器上已經正確安裝了Python解釋器。pip是基於Python運行的，因此Python是其先決條件。您可以通過在命令行輸入python --version或python3 --version來檢查Python版本。
2. 獲取必要的安裝文件
離線安裝pip主要依賴以下幾個Python包：
-
get-pip.py腳本：這是官方推薦的安裝腳本，它會嘗試下載並安裝setuptools和pip本身。 -
setuptools：這是Python的一個核心包，用於構建、分發和安裝Python包。pip依賴於它。 -
wheel：一個用於生成和管理Wheel格式（.whl）Python包的工具。pip在安裝二進位包時會用到它，並且pip本身也可以以Wheel格式提供。 -
pip本身：作為Wheel文件存在，可以手動安裝。
您可以選擇以下兩種方式之一來獲取這些文件：
方式一：下載get-pip.py腳本（推薦）
訪問官方PyPA（Python Packaging Authority）維護的鏈接，下載get-pip.py腳本。
下載地址：
https://bootstrap.pypa.io/get-pip.py
將此腳本下載到您的U盤或任何可移動存儲設備中。當您在離線環境中運行get-pip.py時，它會嘗試安裝setuptools和wheel（如果它們尚未安裝），然後安裝pip。
重要提示： 如果您的目標離線環境是完全隔離的，get-pip.py將無法自行下載依賴。在這種情況下，您需要提前下載好setuptools和wheel的.whl文件，並將它們與get-pip.py放在同一目錄下。
方式二：手動下載setuptools、wheel和pip的.whl文件
如果您希望有更精細的控制，或者get-pip.py在您的特定環境中遇到問題，您可以直接從PyPI下載這些包的Wheel（.whl）文件。
- 訪問PyPI官方網站：
setuptools
wheel
pip -
在每個包的「Download files」或「Files」部分，找到與您的目標離線環境的Python版本和操作系統架構相匹配的
.whl文件。例如，對於Python 3.8的64位Linux系統，您可能會尋找類似pip-23.3.1-py3-none-any.whl或setuptools-68.2.2-py3-none-any.whl這樣的文件。
選擇正確的.whl文件至關重要：py2.py3-none-any.whl：表示同時支持Python 2和Python 3，並且不依賴特定平台（純Python實現）。cpXX-cpXXm-linux_x86_64.whl：表示針對特定Python版本（如cp38代表Python 3.8）和特定平台（如linux_x86_64）的二進位包。
如果您不確定目標機器的Python版本和架構，可以在目標機器上運行python -c "import platform; print(platform.python_version(), platform.machine())"來獲取。
- 將這些
.whl文件下載到您的可移動存儲設備中。
3. 選擇合適的下載環境
用來下載這些文件的有網路環境，最好與目標離線環境的操作系統和Python版本儘可能一致，這樣可以確保下載的.whl文件具有最佳兼容性。
核心步驟：離線安裝pip的詳細方法
將您準備好的所有安裝文件傳輸到目標離線機器上。建議將它們放在一個單獨的文件夾中，例如C:offline_pip_install（Windows）或/tmp/offline_pip_install（Linux/macOS）。
方法一：使用get-pip.py腳本（推薦）
這種方法最簡單，因為它自動化了setuptools和wheel的安裝。
步驟1：將文件傳輸到離線環境
將之前下載的get-pip.py腳本（以及可能需要的setuptools和wheel的.whl文件，如果目標環境完全隔離且get-pip.py無法自行下載依賴）複製到目標離線機器的某個目錄，例如D:pip_installer。
步驟2：在離線環境中執行安裝
打開命令行或終端（在Windows上使用管理員許可權運行CMD或PowerShell，在Linux/macOS上可能需要sudo）。導航到您存放get-pip.py文件的目錄，然後運行以下命令：
cd D:pip_installer
python get-pip.py
如果您有多個Python版本，並且需要為特定版本安裝pip，請使用對應的Python解釋器：
python3 get-pip.py(針對Python 3)
py -3 get-pip.py(Windows上針對Python 3)
腳本會開始執行安裝過程。如果一切順利，您會看到成功的消息。get-pip.py腳本會先嘗試安裝或更新setuptools和wheel，然後安裝pip。
驗證安裝：
安裝完成後，您可以運行以下命令來驗證pip是否已成功安裝及其版本：
pip --version或
pip3 --version
如果顯示了pip的版本信息，則表示安裝成功。
方法二：手動安裝setuptools、wheel和pip的whl文件
如果您選擇手動下載了所有的.whl文件，或者方法一遇到了問題，可以使用此方法。這種方法要求您嚴格按照依賴關係順序安裝。
步驟1：將所有.whl文件傳輸到離線環境
將下載的setuptools-*.whl、wheel-*.whl和pip-*.whl文件全部複製到目標離線機器的某個目錄，例如D:pip_installer。
步驟2：按順序安裝
打開命令行或終端，導航到您存放.whl文件的目錄。然後按照以下嚴格的順序安裝：
-
安裝
setuptools：首先安裝
setuptools，因為它通常是其他包的依賴。python -m pip install setuptools-*.whl或
python3 -m pip install setuptools-*.whl請將
setuptools-*.whl替換為您下載的具體文件名，例如setuptools-68.2.2-py3-none-any.whl。 -
安裝
wheel：接下來安裝
wheel，它對於pip處理.whl文件以及後續安裝其他包至關重要。python -m pip install wheel-*.whl或
python3 -m pip install wheel-*.whl -
安裝
pip：最後安裝
pip本身。python -m pip install pip-*.whl或
python3 -m pip install pip-*.whl
在執行這些命令時，如果系統提示pip命令不存在，這正是我們正在解決的問題。因此，我們使用python -m pip install ...的形式，這會直接調用Python模塊來執行安裝，而不是依賴於環境變數中已經配置的pip命令。
驗證安裝：
同樣，安裝完成後，運行pip --version或pip3 --version來驗證安裝是否成功。
離線安裝Python包（模塊）的策略
成功離線安裝pip后，下一步就是如何使用它來安裝您需要的其他Python包。這同樣需要在有網路的環境中進行預先準備。
1. 在有網路的環境中預下載所需包
在您有網路連接的機器上，使用pip download命令來下載所有目標離線環境中需要的Python包及其依賴。
使用pip download命令
pip download命令可以下載指定包及其所有依賴的Wheel文件到本地目錄。
pip download -d /path/to/downloads package_name
例如，如果您需要安裝requests庫：
pip download -d D:python_packages requests或者在Linux/macOS上：
pip download -d /tmp/python_packages requests
這會將requests及其依賴（如charset-normalizer, idna, urllib3, certifi）的.whl文件下載到指定目錄。
考慮依賴包和平台兼容性
在複雜的項目中，一個包可能依賴於多個其他包，這些依賴鏈條可能很長。pip download會自動處理這些依賴。但是，對於二進位包，您需要確保下載的版本與目標離線環境的Python版本和操作系統架構兼容。
您可以使用以下選項來更精確地控制下載的包版本：
-
--platform：指定目標平台，如manylinux1_x86_64,win_amd64,macosx_10_6_intel。 -
--python-version：指定目標Python版本，如cp38(Python 3.8),cp39(Python 3.9)。 -
--implementation：指定Python實現，如cp(CPython),pypy(PyPy)。 -
--abi：指定ABI（Application Binary Interface），如cp38,abi3。
示例： 為Python 3.8的Linux x86_64環境下載numpy：
pip download -d /path/to/downloads numpy --platform manylinux1_x86_64 --python-version 3.8 --implementation cp --abi cp38
重要提示： 為了確保下載的包在離線環境中可以正常安裝，建議您在與目標離線環境儘可能一致的系統上執行pip download命令。這樣可以避免因平台、Python版本或ABI不匹配導致的兼容性問題。
2. 在離線環境中安裝預下載的包
將所有通過pip download下載的.whl文件傳輸到目標離線機器的某個目錄（例如D:python_packages）。
打開命令行或終端，導航到該目錄，然後使用以下命令來安裝包：
pip install --no-index --find-links=/path/to/packages package_name
參數解釋：
-
--no-index：這個參數告訴pip不要嘗試從PyPI（或其他默認索引）查找包，即完全禁用網路訪問。 -
--find-links=/path/to/packages：這個參數告訴pip在指定的本地目錄中查找所需的包文件。pip會檢查這個目錄中的所有.whl文件，並自動解決依賴關係。
示例： 安裝之前下載的requests庫：
cd D:python_packages
pip install --no-index --find-links=. requests（這裡的
.代表當前目錄，因為我們已經cd到存放包的目錄）
如果您的pip是為python3安裝的，您可能需要使用pip3：
pip3 install --no-index --find-links=. requests
pip會從指定的本地目錄中找到requests及其所有依賴包（前提是它們都被下載到了該目錄中），並按正確的順序進行安裝。
常見問題（FAQ）
如何確認pip是否已成功離線安裝？
在命令行或終端中，輸入pip --version或pip3 --version（如果您的Python安裝為python3）。如果pip成功安裝，它會顯示其版本號，例如pip 23.3.1 from /path/to/site-packages/pip (python 3.x)。如果提示「command not found」或類似錯誤，則表示安裝未成功或pip未添加到系統路徑。
為何我在離線安裝pip后，仍然無法安裝其他包？
這通常是因為您嘗試安裝的包依賴於其他未預先下載到本地的包。在使用pip install --no-index --find-links=/path/to/downloads package_name時，pip只會從--find-links指定的本地路徑中查找包，不會訪問網路。確保您在有網路的環境中，使用pip download -d /path/to/downloads package_name命令時，下載了目標包及其所有遞歸依賴。對於二進位包，還需要確保下載的.whl文件與目標機器的操作系統和Python版本完全兼容。
離線安裝的Python包如何處理其依賴關係？
當您使用pip download命令下載一個包時，pip會自動檢測並下載該包所依賴的所有其他包。在離線安裝時，只要這些依賴包都在您指定的--find-links目錄中，pip就會自動識別並按正確的順序安裝它們。因此，確保您的下載目錄中包含了所有必需的.whl文件是關鍵。
我可以離線升級pip嗎？
可以。離線升級pip的方法與離線安裝其他Python包的方法類似。首先，在有網路的環境中，下載最新版pip的.whl文件，以及其依賴（setuptools和wheel，如果它們也有新版本）。然後，將這些文件傳輸到離線機器，使用pip install --no-index --find-links=/path/to/downloads pip-*.whl命令來升級pip。請記住，在安裝前，同樣需要確保setuptools和wheel的版本也足夠新或與新版pip兼容。
如果離線環境的Python版本較舊，如何選擇合適的包？
對於舊版本的Python（例如Python 2.7），一些現代的包可能不再提供支持。在下載.whl文件時，您需要特別注意文件命名中的Python版本標識符（例如py2、cp27）。在PyPI上，通常可以找到對應舊Python版本的歷史發行版。使用pip download命令時，如果指定了--python-version參數，pip會自動嘗試尋找兼容該版本的包。如果某個包不再支持您的舊Python版本，您可能需要尋找其兼容的舊版本號進行下載。
總結
離線安裝pip和管理Python包是許多受限網路環境中不可或缺的技能。通過遵循本指南中詳述的步驟，無論是使用get-pip.py腳本還是手動安裝.whl文件，您都能夠成功地在無網路連接的環境中搭建和維護您的Python開發和運行環境。
關鍵在於在有網路的環境中做好充分的準備工作，包括下載所有必需的安裝文件及其依賴，並確保它們與目標離線機器的Python版本和操作系統架構兼容。掌握這些方法，將使您在面對網路限制時，依然能夠高效、靈活地進行Python項目管理和部署。希望這篇詳細的離線安裝pip指南能對您有所幫助！
