脚本依赖的第三方库如何离线安装

本文目录导读：

1. 方法一：使用 pip 下载并离线安装（推荐）
2. 方法二：使用 Wheel 文件（.whl）
3. 方法三：使用源码包（.tar.gz / .zip）
4. 方法四：使用 conda（如果使用 conda 环境）
5. 完整示例：处理复杂依赖
6. 注意事项
7. 常见问题解决

离线安装 Python 第三方库通常需要提前在有网络的环境下准备好库文件和依赖，然后传输到离线机器上安装，以下是几种常用方法,按推荐程度排序：

使用 pip 下载并离线安装（推荐）

步骤1：在有网络的环境下载库及其依赖

# 下载单个库及其所有依赖到指定目录
pip download <库名> -d ./offline_packages
# 下载 requirements.txt 中的所有库
pip download -r requirements.txt -d ./offline_packages
# 指定 Python 版本和平台（确保兼容）
pip download --only-binary=:all: --platform linux_x86_64 <库名> -d ./offline_packages

步骤2：将 offline_packages 文件夹传输到离线机器

步骤3：在离线机器安装

# 从本地目录安装
pip install --no-index --find-links ./offline_packages <库名>
# 或安装 requirements.txt 中的所有库
pip install --no-index --find-links ./offline_packages -r requirements.txt

使用 Wheel 文件（.whl）

步骤1：下载 Wheel 文件

• 从 PyPI 手动下载 .whl 文件
• 或使用 pip download --only-binary=:all: <库名> 自动获取

步骤2：安装

pip install 包名.whl

使用源码包（.tar.gz / .zip）

步骤1：下载源码包

从 PyPI 或 GitHub Releases 下载源码包

步骤2：安装

# 解压并安装
tar -xzf package.tar.gz
cd package
python setup.py install
# 或直接使用 pip 安装
pip install package.tar.gz

使用 conda（如果使用 conda 环境）

# 有网络环境下载
conda download <包名> -p ./离线包
# 离线安装
conda install --offline ./离线包/包名.tar.bz2

完整示例：处理复杂依赖

生成 requirements.txt（有网络环境）

pip freeze > requirements.txt

下载所有依赖（包括间接依赖）

pip download -r requirements.txt -d ./offline_packages

创建安装脚本 install_offline.sh

#!/bin/bash
pip install --no-index --find-links ./offline_packages -r requirements.txt

传输文件夹到离线机器并运行

scp -r offline_packages user@offline-server:/path/to/project/
ssh user@offline-server
cd /path/to/project
bash install_offline.sh

注意事项

1. 依赖完整性：确保下载了所有间接依赖，可使用 pip download 自动处理
2. 平台兼容性：如果离线机器架构不同（如 Mac 到 Linux），需指定平台参数
3. Python 版本：下载时指定与离线环境相同的 Python 版本
4. 二进制兼容：Windows 需注意 32/64 位，Linux 注意 glibc 版本
5. 使用 requirements.txt：推荐使用 -r requirements.txt 确保版本一致

常见问题解决

• 提示找不到库：检查下载目录是否包含所有依赖
• 编译错误：某些库需要 C 编译器，下载 --only-binary 版本
• 版本冲突：在 requirements.txt 中固定版本号

如果需要更详细的某种方法或遇到具体问题,请告诉我！