要进行Python库的离线安装，核心思路是：在可联网的环境下，将所需的库及其依赖预先下载为文件（如`.whl`或源码包），然后传输到离线环境，并使用特定命令进行安装。以下是详细的步骤和注意事项。 ### 一、基础方法：使用 `pip download` 和 `requirements.txt` 这是最常用的方法，通过一个依赖清单文件来批量下载和安装。 **操作步骤如下：** 1. **在可联网的计算机上，生成项目依赖清单 (`requirements.txt`)**。 在项目根目录下执行以下命令，可以生成项目实际使用的依赖列表（推荐使用 `pipreqs`，它比 `pip freeze` 更精确）[ref_5]。 ```bash # 安装 pipreqs 工具 pip install pipreqs # 扫描当前项目目录，生成 requirements.txt pipreqs ./ --encoding=utf-8 --force ``` 如果希望导出整个虚拟环境的所有库，可以使用 `pip freeze` 命令[ref_5]。 ```bash pip freeze > requirements.txt ``` 2. **下载所有依赖包到本地目录**。 使用 `pip download` 命令，根据 `requirements.txt` 清单，将包及其依赖下载到指定文件夹（如 `offline_packages`）[ref_3][ref_6]。 ```bash # 命令基本格式 pip download -r requirements.txt -d ./offline_packages # 如果下载速度慢，可以添加国内镜像源，如： pip download -r requirements.txt -d ./offline_packages -i https://pypi.tuna.tsinghua.edu.cn/simple ``` 3. **将依赖包文件夹和 `requirements.txt` 拷贝到离线计算机**。 通过U盘、硬盘或内部网络将 `offline_packages` 文件夹和 `requirements.txt` 文件传输到离线环境的目标机器上。 4. **在离线计算机上进行安装**。 在离线环境中，切换到存放离线包的目录，使用 `pip install` 命令进行安装[ref_5]。 ```bash # 离线安装 requirements.txt 中列出的所有包 pip install --no-index --find-links=./offline_packages -r requirements.txt ``` 参数说明： * `--no-index`：忽略 PyPI 索引，不从网络查找包。 * `--find-links=./offline_packages`：指定本地包文件的存放目录。 ### 二、使用 `.whl` 文件进行离线安装 `.whl` 文件（Wheel）是Python包的预编译二进制分发格式，安装速度通常比源码包更快[ref_1]。 **操作步骤如下：** 1. **在可联网环境下下载特定库的 `.whl` 文件**。 可以通过以下途径获取： * **官方PyPI或镜像站**：直接访问如 [https://pypi.org/](https://pypi.org/) 或国内镜像站（如清华、阿里云），搜索库名，在“Download files”部分找到对应平台和Python版本的 `.whl` 文件手动下载[ref_1][ref_4]。 * **使用 `pip download` 命令**：指定库名和下载目录，会自动下载对应的 `.whl` 文件[ref_6]。 ```bash pip download package_name -d ./wheel_files ``` **注意：** 需确保下载的 `.whl` 文件与离线环境的操作系统（如 Windows/Linux）、Python版本（如 3.8/3.9）和架构（如 64 位）完全匹配[ref_4]。一个复杂的库（如`matplotlib`）可能有多个依赖，需要将所有依赖的 `.whl` 文件一并下载[ref_4]。 2. **传输并安装**。 将下载好的 `.whl` 文件及依赖包文件拷贝到离线机，然后使用 `pip install` 安装。 ```bash # 进入存放 .whl 文件的目录 cd ./wheel_files # 安装单个包 pip install package_name-version-py3-none-any.whl # 批量安装当前目录下所有 .whl 文件 pip install *.whl ``` ### 三、针对 Anaconda 环境的离线安装 如果离线环境使用的是 Anaconda 或 Miniconda 进行包管理，可以采用 `conda` 相关的离线安装方法[ref_2]。 **操作步骤如下：** 1. **在联网环境中准备环境**。 使用 `conda` 创建一个虚拟环境并安装所需库，或者直接导出现有环境的配置[ref_2]。 ```bash # 导出当前环境的包列表（精确版本） conda list --explicit > spec-list.txt # 或导出通用包列表（不指定版本） conda env export > environment.yml ``` 2. **下载依赖包**。 对于 `spec-list.txt` 方式，需要手动在联网机的 `pkgs_dirs`（通常在 `Anaconda3/pkgs` 目录）中找到对应的包文件，或使用 `conda pack` 将整个环境打包[ref_2]。 ```bash # 打包名为 myenv 的虚拟环境 conda pack -n myenv -o myenv.tar.gz ``` 3. **在离线环境中创建环境或安装包**。 * **如果打包了整个环境**：将 `myenv.tar.gz` 文件拷贝到离线机，解压到 `Anaconda3/envs/` 目录下即可使用。 * **如果拷贝了包文件 (`*.tar.bz2`)**：将文件放在离线机的 `pkgs` 目录下，然后通过 `conda install --offline` 命令安装。 * **使用 `spec-list.txt`**： ```bash conda create --name my_offline_env --file spec-list.txt ``` ### 四、不同方法对比与选择建议 为了方便选择，下表对几种主要方法进行了比较： | 方法 | 适用场景 | 优点 | 缺点/注意事项 | | :--- | :--- | :--- | :--- | | **`pip download` + `requirements.txt`** | 项目依赖明确，需要批量迁移。 | 流程标准化，可完整下载依赖链，易于复用[ref_5][ref_6]。 | 需确保联网和离线环境的操作系统、Python版本一致，否则下载的包可能不兼容。 | | **手动下载 `.whl` 文件** | 安装单个或少数几个库，或解决特定平台依赖。 | `.whl` 文件通常安装更快，适合Windows等系统[ref_1]。 | 需要手动处理依赖关系，库的依赖也需要一并下载[ref_4]。 | | **`conda` 环境打包** | 使用 Anaconda 进行科学计算，环境复杂。 | 能处理非Python依赖（如C库），环境隔离性好[ref_2]。 | 打包文件体积较大，`conda` 环境在不同机器间迁移需注意路径问题。 | | **源码包 (`tar.gz`)安装** | 无法找到预编译的 `.whl` 文件，或需自定义编译。 | 通用性最强，只要有源码和编译器即可。 | 需要离线环境具备编译工具链（如gcc），安装过程可能出错[ref_1]。 | **总结与建议：** * **通用首选方案**：对于大多数纯Python项目，推荐使用 **方法一（`pip download` + `requirements.txt`）**。这是最规范、最不容易出错的方式[ref_3][ref_5]。 * **关键注意事项**： 1. **环境一致性**：务必确保下载包的环境（操作系统、CPU架构、Python主版本）与离线安装环境**高度一致**，尤其是涉及C扩展的库（如`pandas`, `numpy`）[ref_4]。 2. **处理依赖**：离线安装时，所有依赖库也必须离线提供。使用 `pip download` 命令能自动下载依赖，而手动下载 `.whl` 文件则需自行解决依赖树。 3. **虚拟环境**：强烈建议在离线机上使用虚拟环境（如 `venv` 或 `conda`）进行安装，避免污染系统Python环境，也便于管理[ref_2][ref_4]。