必须用--no-index与--find-links组合，否则pip仍会联网校验依赖；报“Could not find a version”是因pip解析requires-dist后默认访问PyPI，而非文件缺失；正确做法是--no-index禁用索引，--find-links指定扁平wheel目录（如file:///D:/wheels），并确保所有依赖wheel及平台标签完全匹配目标机。
必须用 --no-index + --find-links 组合，否则 pip 仍会尝试联网校验依赖，哪怕你指定了本地 .whl 文件。
为什么 pip install xxx.whl 会报 “Could not find a version that satisfies the requirement”
这不是文件没找到，而是 pip 在安装单个 .whl 时，仍会解析其 requires-dist 字段，并默认去 PyPI 查询依赖项版本。即使你本地有 requests-2.31.0-py3-none-any.whl，它依赖的 charset-normalizer 若未提前装好，pip 就会触发网络请求失败。
- 错误现象：
ERROR: Could not find a version that satisfies the requirement charset-normalizer>=2.0.0，但你明明有对应.whl - 根本原因：缺少
--no-index，pip 没被禁止访问远程索引 - 正确做法：始终搭配使用
--no-index --find-links file:///path/to/wheels（注意是file://协议，不是相对路径） - Windows 下路径示例：
--find-links file:///D:/wheels；Linux 下：--find-links file:///home/user/wheels
如何确保 wheel 文件 100% 兼容目标机器
平台标签不匹配是离线安装失败最常见原因——cp39-win_amd64 和 cp311-manylinux_x86_64 完全不互通，混在一起会导致直接跳过或报错。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 在目标离线机上运行：
python -c "import pip._vendor.packaging.tags; print(list(pip._vendor.packaging.tags.sys_tags())[0])"，输出就是你唯一能用的完整标签（如cp39-cp39-win_amd64） - 外网打包时必须显式指定：
pip download --platform win_amd64 --python-version 39 --abi cp39 --only-binary=:all: -d ./wheels requests==2.31.0 - 验证已下载的 wheel：
python -c "from wheel import wheelfile; print(wheelfile.WheelFile('numpy-1.26.4-cp39-cp39-win_amd64.whl').tags)"，确认输出含目标标签 - 不要用
pip wheel直接从源码编译——它默认按当前环境打标签，极易出错
批量安装命令与依赖顺序怎么写才不翻车
用 -r requirements.txt 是最可控的方式，但要求 requirements.txt 写的是包名+版本（如 requests==2.31.0），不是 .whl 文件名；且所有依赖的 .whl 必须已存在 --find-links 目录中。
立即学习“Python免费学习笔记（深入）”；
- 推荐命令：
pip install --no-index --find-links file:///D:/wheels -r requirements.txt - 加
--force-reinstall可避免因已有旧版本导致跳过安装（尤其适合清空重装场景） - 不建议用
pip install ./wheels/*.whl：它不处理依赖顺序，numpy可能先于openblas被装，导致导入失败 - 若
requirements.txt里有纯 Python 包（py3-none-any）和 C 扩展包混用，确保目录里两者都有对应 wheel，pip 不会自动 fallback 到源码
最容易被忽略的一点：pip 不会递归扫描子目录。哪怕你把所有 .whl 放在 wheels/dep1/ 和 wheels/dep2/ 里，--find-links file:///wheels 也只看 wheels/ 顶层目录。路径必须扁平，一个文件夹，全是 .whl。
