conda不支持直接安装.whl文件，因其仅识别.tar.bz2格式；正确做法是先激活conda环境，再用pip install安装本地.whl文件，并确保.whl与Python版本、系统平台及CUDA版本（如PyTorch）严格匹配。
conda install --offline 不能装 .whl 文件
直接用 conda install --offline xxx.whl 会报错，比如 CondaValueError: could not parse 'xxx.whl'。因为 conda 原生不支持解析 .whl 格式——它只认 .tar.bz2 包（conda 自己的包格式）。.whl 是 pip 的轮子，不是 conda 的“语言”。强行用 conda 装 .whl，就像拿螺丝刀拧螺母，方向对不上。
正确做法：在 conda 环境里用 pip install
你得先激活目标 conda 环境，再用 pip install 安装本地 .whl 文件。这是最可靠、最通用的方式，无论 Windows/macOS/Linux 都一样。
- 打开
Anaconda Prompt（Windows）或终端（macOS/Linux） - 运行
conda activate myenv（把myenv换成你的环境名） - 确认当前 Python 解释器路径是否正确：
which python（macOS/Linux）或where python（Windows），输出应指向该 conda 环境下的python.exe或python - 执行
pip install C:\path\to\package.whl（Windows）或pip install /path/to/package.whl（macOS/Linux）
常见失败原因和绕过方法
装完后 pip list 看不到包？或者报 ERROR: xxx.whl is not a supported wheel on this platform？大概率是平台/Python 版本不匹配。
-
GDAL-3.8.4-cp311-cp311-win_amd64.whl这种名字里的cp311表示必须用 Python 3.11；如果你环境是 Python 3.9，就装不上 - GPU 版 PyTorch 的 .whl 名字里带
cu118或cu121，对应 CUDA 11.8 或 12.1，装错版本会 import 失败 - 不要依赖浏览器自动下载的文件名——右键“属性”看真实文件名，尤其注意下划线和连字符是否被系统改写
- 如果 pip 报
requires-python>=3.10冲突，别硬装，换匹配的 .whl，或者重建一个对应版本的 conda 环境
为什么不用 pip install --user 或全局 pip？
在 conda 环境里用全局 pip 或加 --user，极大概率导致包装到错误位置，后续 import 找不到模块，甚至破坏 base 环境。所有操作必须确保：pip 命令调用的是当前 conda 环境里的 pip（可通过 pip --version 验证路径是否含 envs/myenv/）。
真正容易被忽略的点是：conda 环境的 pip 和系统 pip 是两个独立实例，路径、site-packages、甚至 pip 版本都可能不同。装之前不验证，后面 debug 会花掉几小时。
