这个错误提示是:
✅ pip 检测到:安装的
torch==2.5.1+cpu
的.whl
文件 实际的哈希值和预期不一致。
Expected sha256 = 2ebd0b6...
Got = 240ad0c...
❗ 原因解析:
这个报错出现的前提是运行了像这样的命令:
pip install -r requirements.txt
或者使用的安装链接中带了 #sha256=...
这样的限制(用于校验包是否被篡改)。
✅ 实际原因多为:
- 官方的
.whl
文件更新了内容,但链接没有改,导致哈希值对不上(很常见) - 网络中断导致下载文件损坏(不完整)
- 安装缓存问题(老文件和新 hash 冲突)
✅ 最快解决方案:
✅ 1. 忽略哈希校验,强制安装
可以直接运行以下命令跳过 hash 校验:
pip install torch==2.5.1+cpu --index-url https://download.pytorch.org/whl/cpu --no-cache-dir --no-deps
然后继续安装其他包即可。
✅ 2. 或者:使用 --no-hash
的方式清理依赖文件(适用于 requirements.txt
安装)
如果在用 requirements.txt
,请删除里面的 --hash=sha256...
相关内容,改成:
torch==2.5.1+cpu --index-url https://download.pytorch.org/whl/cpu
✅ 3. 清理 pip 缓存(可选)
pip cache purge
或手动删除缓存目录:
# Windows:
%LOCALAPPDATA%\pip\Cache
✅ 结论
可以安全地忽略这个 hash 错误,使用以下命令直接装 PyTorch:
pip install torch==2.5.1+cpu --index-url https://download.pytorch.org/whl/cpu --no-cache-dir --no-deps