离线安装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指南能对您有所帮助！
