【Python] pip制作离线包

制作离线安装包是一种非常实用的方法，尤其是在网络环境受限或需要在多台机器上部署相同环境时。以下是详细的步骤，帮助您创建一个包含所有依赖项的离线安装包，并在后续环境中复用。

---

步骤 1：准备工具和环境

确保您有一台可以访问互联网的机器（称为“在线机器”），以及一台无法访问互联网的机器（称为“离线机器”）。我们将使用在线机器下载所有必要的文件，然后将这些文件传输到离线机器。

---

步骤 2：创建 requirements.txt 文件

在在线机器上，列出所有需要安装的 Python 包及其版本号。例如：

requests==2.28.1
numpy==1.23.5
pandas==1.5.2
flask==2.2.2

将上述内容保存为 requirements.txt 文件。

---

步骤 3：下载所有依赖项

使用 pip download 命令下载 requirements.txt 中列出的所有包及其依赖项。

1. 创建一个目录用于存放下载的包：

   mkdir offline_packages
   

2. 使用 pip download 下载所有依赖：

   pip download -r requirements.txt -d offline_packages
   

   这会将所有需要的 .whl 或 .tar.gz 文件下载到 offline_packages 目录中。

---

步骤 4：打包离线安装文件

将下载的文件打包成一个压缩文件，以便传输到离线机器。

1. 使用 tar 或 zip 打包：

   tar -czvf offline_packages.tar.gz -C offline_packages .
   

   或者：

   zip -r offline_packages.zip offline_packages
   

2. 将生成的压缩文件（如 offline_packages.tar.gz）复制到离线机器（可以通过 U 盘、SCP 或其他方式传输）。

---

步骤 5：在离线机器上安装

在离线机器上解压并安装所有包。

1. 解压压缩文件：

   tar -xzvf offline_packages.tar.gz -C /path/to/extract/
   

   或者：

   unzip offline_packages.zip -d /path/to/extract/
   

2. 使用 pip install 安装所有包：

   pip install --no-index --find-links=/path/to/extract/offline_packages -r requirements.txt
   

   • --no-index：告诉 pip 不要从 PyPI 下载包。
   • --find-links：指定本地包的路径。

---

注意事项

1. Python 版本一致性：

   • 确保在线机器和离线机器上的 Python 版本一致（包括主版本号和次版本号，如 3.8.x 和 3.9.x 之间可能有兼容性问题）。

2. 操作系统兼容性：

   • 如果在线机器和离线机器的操作系统不同（例如一个是 Linux，另一个是 Windows），可能会导致某些二进制包（.whl 文件）不兼容。在这种情况下，建议下载源码包（.tar.gz）并在离线机器上编译。

3. 虚拟环境：

   • 如果您使用了虚拟环境（如 venv 或 virtualenv），请确保在离线机器上也创建相同的虚拟环境后再安装包。

4. 依赖项冲突：

   • 如果您的项目依赖复杂，可能存在依赖冲突。建议在在线机器上测试安装是否成功，再进行离线部署。

---

扩展：制作完整的 Python 环境离线包

如果您需要将整个 Python 环境（包括解释器和所有依赖项）打包为离线安装包，可以使用以下工具：

方法 1：使用 pipenv

pipenv 是一个高级包管理工具，可以自动生成锁文件（Pipfile.lock），确保环境的一致性。

1. 在在线机器上安装 pipenv：

   pip install pipenv
   

2. 初始化项目并安装依赖：

   pipenv install requests numpy pandas flask
   

3. 打包整个环境：

   pipenv lock --requirements > requirements.txt
   pip download -r requirements.txt -d offline_packages
   

4. 按照上述步骤将文件传输到离线机器并安装。

方法 2：使用 conda

conda 是一个强大的包管理工具，适合科学计算和复杂依赖场景。

1. 在在线机器上创建环境并导出配置：

   conda create -n myenv python=3.9
   conda activate myenv
   conda install requests numpy pandas flask
   conda list --explicit > environment.txt
   

2. 在离线机器上恢复环境：

   conda create --name myenv --file environment.txt
   

---

总结

通过上述步骤，您可以轻松制作一个离线安装包，并在多台机器上复用。推荐的方法是：

1. 使用 pip download 下载所有依赖项。
2. 打包并传输到离线机器。
3. 使用 pip install --no-index 安装。

如果您在操作过程中遇到任何问题，请提供具体的错误信息或描述您的需求，我将进一步协助您解决！