Numpy Python库安装失败-无效哈希值

最近，有一些Python开发者报告了在安装Numpy时遇到了失败的情况，错误信息显示为“invalid hashes”（即无效哈希值）。下面就让我们一起了解这种问题的原因和解决方案。

阅读更多：Numpy 教程

什么是哈希值？

哈希值是一个固定长度的字节序列，用于表示任何给定的消息或数据块。它可以唯一地标识任何数据，即使数据很大，哈希值只是一个非常小的数字。

在Python中，哈希值可以使用内置的hash()函数计算。例如，我们可以使用以下代码来计算字符串“Hello”的哈希值：

hash("Hello")

输出结果是：-865116067860138540

为什么会出现“invalid hashes”错误？

在Python中，许多第三方库的安装需要从PyPI（Python Package Index）服务器上下载安装文件，其中包含了哈希值。在安装时，Python会计算下载文件的哈希值并与安装文件中提供的哈希值进行比较，以确保下载的文件与预期的文件相同。

如果下载的文件的哈希值与安装文件中提供的哈希值不匹配，则会出现“invalid hashes”错误。这通常是由于从PyPI服务器下载的文件已经被更改或被破坏，并且哈希值不再匹配所致。

如何解决“invalid hashes”错误？

解决“invalid hashes”错误的方法很简单:

方法一：更新pip和setuptools：

首先，您需要确保您正在使用最新版本的pip和setuptools。您可以通过运行以下命令来更新它们：

pip install --upgrade pip setuptools

方法二：删除缓存文件并重新安装：

如果升级pip和setuptools后仍然遇到“invalid hashes”错误，您可以尝试删除缓存文件并重新安装：

pip cache purge
pip install --no-cache-dir numpy

方法三：自行计算哈希值并重命名文件：

如果以上两种方法都无法解决问题，您可以手动计算文件的哈希值并将其添加到安装文件中，并将文件重命名为安装文件的名称。例如，如果您要安装的文件名为“numpy-1.21.0-cp39-cp39-win_amd64.whl”，则可以使用以下命令计算哈希值：

import hashlib

hashlib.sha256(b"numpy-1.21.0-cp39-cp39-win_amd64.whl").hexdigest()

运行此命令后，您将获得一个哈希值，例如“9a6aed9d3cb9eefb07a559be86f3f63aa00ae1d2610667262c8757f7fd39fd15”。您可以将该哈希值添加到安装文件中，并将文件名修改为“numpy-1.21.0-cp39-cp39-win_amd64.whl.sha256”。

然后，您可以使用以下命令安装您手动修改的安装文件：

pip install --no-cache-dir numpy --no-index --find-links=./

总结

“invalid hashes”错误是由于下载的文件被更改或被破坏导致的，可以通过升级pip和setuptools、删除缓存文件、手动计算哈希值并添加到安装文件并重命名为安装文件的名称等方式进行解决。这些解决方案不仅适用于Numpy库，也适用于其他Python库的安装问题。希望本文中的方法可以帮助您修复该问题。