Python离线安装包

Python离线安装包完整指南

一、整体流程概述

离线安装的核心步骤：

1. 联网环境：下载目标包及所有依赖的whl文件
2. 文件传输：将下载的文件拷贝到离线电脑
3. 离线安装：在目标环境中安装这些包

二、联网环境下载包

1. 基本下载命令

# 创建下载目录
mkdir offline_packages

# 下载单个包及其所有依赖
pip download package_name -d ./offline_packages

# 使用国内镜像源（推荐清华源）
pip download package_name -d ./offline_packages \
    -i https://pypi.tuna.tsinghua.edu.cn/simple/

2. 指定Python版本和平台

# 为特定Python版本和平台下载
pip download package_name -d ./offline_packages \
    -i https://pypi.tuna.tsinghua.edu.cn/simple/ \
    --python-version 3.10 \
    --platform win_amd64 \
    --only-binary :all:

常用平台参数：

• win_amd64 - Windows 64位
• linux_x86_64 - Linux 64位
• macosx_10_9_x86_64 - macOS 64位

3. 批量下载（使用requirements.txt）

# 生成requirements.txt（可选）
pip freeze > requirements.txt

# 批量下载
pip download -r requirements.txt -d ./offline_packages \
    -i https://pypi.tuna.tsinghua.edu.cn/simple/

三、离线环境安装

方法A：纯Python环境

# 1. 安装单个包
pip install --no-index --find-links ./offline_packages package_name

# 2. 安装所有whl文件
pip install --no-index --find-links ./offline_packages *.whl

# 3. 使用requirements.txt安装
pip install --no-index --find-links ./offline_packages -r requirements.txt

方法B：Anaconda环境

# 1. 激活目标conda环境
conda activate myenv

# 2. 使用conda环境中的pip安装
# 确保使用的是conda环境内的pip
python -m pip install --no-index --find-links ./offline_packages package_name

# 或者
pip install --no-index --find-links ./offline_packages *.whl

方法C：创建自动安装脚本

创建 install_offline.py：

import subprocess
import sys
import os
import glob

def install_offline_packages(packages_dir):
    """自动安装离线包目录中的所有whl文件"""
    
    # 获取所有whl文件
    whl_files = glob.glob(os.path.join(packages_dir, "*.whl"))
    
    if not whl_files:
        print("未找到whl文件")
        return
    
    # 按依赖顺序安装
    for whl_file in sorted(whl_files):
        print(f"正在安装: {
     
     os.path.basename(whl_file)}")
        try:
            subproc