Windows环境pip离线安装Python包无法找到本地依赖问题咨询

直接执行pip install <单个whl文件路径>时，pip仅将你传入的单个文件作为安装目标，不会自动扫描同目录下的其他whl文件作为依赖来源，默认会走配置的在线PyPI源拉取依赖，纯离线环境下就会触发网络重试、依赖找不到的报错。

第一步：联网端预下载全量适配的安装包 #

提前确认离线设备的Python版本、系统架构（可在离线端执行python -c "import sys,platform; print(f'平台：{platform.machine()}, Python版本：{sys.version_info.major}{sys.version_info.minor}')"获取），在联网设备上执行下载命令，将目标包及所有依赖下载到独立目录：

pip download <目标包名> --platform <对应平台标识> --python-version <对应Python版本号> --only-binary=:all: -d ./offline_pkgs

参数说明：

• --platform：Win10 64位填win_amd64，32位填win32，ARM架构Win设备填win_arm64
• --python-version：比如Python3.9就填39，Python3.10就填310
• --only-binary=:all:：强制下载whl格式的预编译包，避免下载源码包导致离线环境无编译工具安装失败
• -d ./offline_pkgs：所有包统一存到offline_pkgs目录

例如下载适配Win10 64位、Python3.10的beautifulsoup4全量包，命令为：

pip download beautifulsoup4 --platform win_amd64 --python-version 310 --only-binary=:all: -d ./offline_pkgs

第二步：离线端安装 #

将整个offline_pkgs目录完整拷贝到离线设备后，不要直接指定单个whl文件安装，执行以下命令即可让pip自动识别本地依赖、按正确顺序安装，全程不会触发联网请求：

pip install <要安装的包名> --no-index --find-links=./offline_pkgs

参数说明：

• --no-index：完全禁用pip的在线源查询逻辑，不会发起任何网络请求
• --find-links：指定pip扫描本地包的路径，会自动解析该路径下所有whl的依赖关系，不需要手动梳理安装顺序

如果需要批量安装目录下的所有Python包，直接执行：

pip install --no-index --find-links=./offline_pkgs ./offline_pkgs/*.whl

• 不要修改下载得到的whl文件名，文件名里包含了包适配的Python版本、平台信息，改名后pip可能无法正确识别。
• 如果待安装的包是纯Python无平台依赖的（比如beautifulsoup4这类py3-none-any.whl格式的包），下载时可以省略--platform和--python-version参数，跨版本跨平台通用。
• 如果离线设备的pip版本过低，先提前下载对应pip版本的whl包，离线升级pip后再执行安装操作，避免低版本pip不支持新的whl格式识别。

内容的提问来源于stack exchange，提问作者EllipticalInitial