pip install是最直接可靠的离线安装方式，conda不原生支持纯离线依赖解析，强行使用--use-local易漏依赖或冲突；必须从pypi或清华等可信镜像按环境精确匹配cp版本、平台标签下载.whl/.tar.gz，优先选预编译wheel；安装报“no matching distribution”主因是python版本或platform tag不匹配，需用pip debug --verbose查兼容标签；纯python包用pip即可，但conda-only发布、强依赖系统库或需多python共用底层c库时必须用conda；批量安装应通过pip install --no-index --find-links ./pkgs -r requirements.txt自动解依赖，而非循环安装；务必验证环境abi一致性和包功能可用性。
pip install 是最直接、最可靠的方式，只要包文件完整且环境匹配，基本不会出错。conda 本身不原生支持纯离线依赖解析，强行用 conda install --use-local 容易漏依赖或版本冲突，尤其对非 conda-forge 渠道发布的包（比如 wandb、pyrep、自研库）几乎不可靠。
怎么下载到正确的 .whl 或 .tar.gz 文件
不能随便搜“xxx whl 下载”就点进去——很多非官方镜像会混入篡改版或架构错配的包。必须从 PyPI 官方页或可信镜像（如清华源）按需构造 URL：
- 进 https://www.php.cn/link/4b6cf59a2a5b31fc68aa6f9524067ef8 搜索包名，点进项目页，看右侧 “Download files” 列表
- 重点核对文件名中的三段标识：
cp311（Python 版本）、win_amd64（Windows 64 位）、manylinux_2_17（Linux 兼容标签），必须和你离线机的 Python 和系统完全一致 - 优先选
.whl（预编译二进制），除非包明确不提供（如某些含 C 扩展但未上传 wheel 的旧包），才退而求其次用.tar.gz - 如果包有复杂依赖（如
wandb依赖graphql-core、watchdog等），别只下主包——用联网机提前跑pip download wandb -d ./pkgs，它会把整棵树都拉下来
安装时为什么报 “No matching distribution found”
这是离线安装里最高频的错误，根本原因只有两个：Python 版本不匹配，或平台标签（platform tag）对不上。例如你在 Python 3.12 环境下双击安装了标着 cp311 的 wandb 包，必然失败。
- 查当前环境 Python 版本：
python -c "import sys; print(sys.version)" - 查 pip 支持的标签：
pip debug --verbose | findstr "tags"（Windows）或pip debug --verbose | grep tags（Linux/macOS）——输出里第一行就是你环境能接受的最高兼容标签 - 不要试图用
--force-reinstall绕过校验，它不会修复 ABI 不兼容问题，只会让后续 import segfault - 若实在找不到匹配的 wheel，可尝试从源码安装：
tar -xzf xxx.tar.gz && cd xxx && python setup.py install，但需确保离线机已装好对应编译工具链（如 Visual Studio Build Tools / gcc）
用 pip 还是 conda？什么时候必须用 conda
绝大多数纯 Python 包（requests、numpy、scikit-learn）用 pip install xxx.whl 即可，干净利落。但以下三类必须走 conda：
Anaconda 2024.10-1
下载
Anaconda 2024.10-1 官方 Windows x86_64 安装包下载，来自 Anaconda 官方归档目录，适合需要安装旧版 Anaconda Distribution 的用户。
- 包本身是 conda-only 发布的（如
anaconda-client、某些 Intel MKL 加速版numpy） - 包强依赖系统级共享库（如
cuda-toolkit、ffmpeg），pip 无法管理这些二进制依赖 - 你需要在多个 Python 版本间共用同一份底层 C 库（比如同时跑 py39/py311 环境，都调用同一个
openblas）
注意：conda 离线安装不是简单把 .bz2 往环境里一扔就行。必须用 conda install --use-local path/to/package.bz2，且该 .bz2 必须来自与目标环境同源的 channel（比如都是 conda-forge），否则依赖解析会静默失败。
批量安装多个离线包，怎么避免手动一个一个敲
别用循环写 shell 脚本去 pip install *.whl——当某个包依赖另一个还没装的包时，pip 会直接报错退出，后续包全被跳过。
- 正确做法：先在联网机生成带版本锁的依赖清单：
pip freeze > requirements.txt（适用于已装好的环境），或更稳妥地用pip download -r requirements.txt -d ./pkgs --no-deps+pip download -r requirements.txt -d ./pkgs --no-binary :all:组合拉全 - 离线机上执行：
pip install --no-index --find-links ./pkgs -r requirements.txt——这个命令会让 pip 在本地目录里主动查找并解依赖，顺序自动处理 - 如果
requirements.txt里混了 conda-only 包（如pytorch），得拆开：pip 部分用上面命令，conda 部分单独用conda install --use-local *.bz2
conda activate your_env && python -c "import platform; print(platform.architecture(), platform.machine())" 记下 ABI 信息；安装后，在离线机上运行 python -c "import xxx; xxx.__version__" 仅能说明 import 不报错，还得跑包自带的 minimal test（比如 wandb login --relogin 或 numpy.test()）确认功能可用。否则，可能只是“表面上装上了”。
