本文详细讲解如何在无网络连接的 windows 环境中，利用本地 wheel/tar.gz 包和 requirements.txt 文件完成 python 依赖的离线批量安装，重点解决因缺失 `wheel` 或构建依赖导致的安装失败问题。
在企业内网、工业控制或高安全等级的隔离环境中，Python 项目常需部署于完全断网的 Windows 主机上。此时，直接运行 pip install -r requirements.txt 会失败——pip 默认尝试从 PyPI 在线索引解析并下载依赖，而离线环境下必须显式提供所有依赖包（包括构建工具）及其兼容版本。
你已正确完成了前期关键步骤：
✅ 在联网机器上用 pip freeze > requirements.txt 生成精确依赖清单；
✅ 使用 pip download -r requirements.txt --no-deps --platform win_amd64 --python-version 38 --abi cp38 --only-binary=:all:（根据实际 Python 版本调整）下载了 .whl 和 .tar.gz 包；
✅ 将全部文件（含 requirements.txt）复制到目标离线机指定目录（如 C:\Users\pulcma\pip）。
但当前报错揭示了一个典型陷阱：
ERROR: Could not find a version that satisfies the requirement wheel (from versions: none)
这是因为 clipboard-0.0.4.tar.gz 是源码包（sdist），pip 安装时需先构建（需 setuptools + wheel + pip 三者协同）。虽然你已下载 setuptools-41.2.0-py2.py3-none-any.whl，但 wheel 包本身缺失——它未被自动包含在 pip download 的默认依赖链中，必须手动单独下载并预装。
✅ 正确操作流程（Windows 离线环境）
1. 补全核心构建依赖（联网机执行）
在有网机器上，额外下载 wheel 和最新版 pip（可选但推荐）：
立即学习“Python免费学习笔记（深入）”；
pip download wheel pip --no-deps --only-binary=:all:
将生成的 wheel-*.whl 和 pip-*.whl 复制到离线机 C:\Users\pulcma\pip\ 目录下。
2. 预装构建工具（离线机 PowerShell 执行）
# 进入包所在目录 cd C:\Users\pulcma\pip # 优先安装 wheel（解决报错根源） pip install wheel-*.whl # 可选：升级 pip 以获得更好离线兼容性 pip install pip-*.whl # 验证安装 pip list | findstr "wheel pip"
3. 批量安装业务依赖
pip install -r requirements.txt ` --find-links=C:\Users\pulcma\pip ` --no-index ` --trusted-host None # 避免潜在 host 检查（离线时安全）
⚠️ 关键注意事项 版本严格匹配：确保离线机 Python 版本（如 3.8）、架构（win_amd64）与下载包的 cp38-cp38-win_amd64 标签完全一致，否则 pip 会跳过该包并报“no matching distribution”。 避免混合源码/二进制：.tar.gz 包（如 clipboard, future）需编译，易因缺失 VC++ 构建工具失败。强烈建议优先下载纯二进制 .whl： # 联网机命令（指定平台+Python版本+仅二进制） pip download -r requirements.txt ^ --platform win_amd64 ^ --python-version 38 ^ --abi cp38 ^ --only-binary=:all:处理间接依赖：若 requirements.txt 中某包（如 paramiko）依赖 cryptography，而后者又依赖 cffi 和 pycparser，则 pip download 必须加 --no-deps 后手动补全所有传递依赖，或改用 --no-deps + --find-links 组合确保目录包含全量包。 权限问题：PowerShell 中若提示“execution policy”，临时启用脚本： Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
✅ 验证与故障排查
安装完成后，运行：
pip list --outdated # 应无输出（离线环境无法检查更新）
python -c "import netmiko, cryptography; print('Success!')"若仍报错 No module named 'xxx'，检查：
- 是否遗漏了某个依赖包（如 bcrypt 依赖 cffi，需确认 cffi-*.whl 已存在且版本兼容）；
- requirements.txt 中包名是否与 wheel 文件名一致（如 PyYAML 对应 PyYAML-*.whl，非 pyyaml）；
- 使用 pip install --verbose ... 查看详细日志，定位跳过的包。
通过以上步骤，你即可在零网络连接的 Windows 环境中，实现 Python 项目的可复现、可审计、高可靠部署。
