Windows虚拟环境安装hikari库时wheel构建失败求助

问题背景 #

在Windows环境的虚拟环境中执行python3 -m pip install hikari时，出现编译依赖包失败的错误：

ERROR: Could not build wheels for aiohttp, multidict, frozenlist, yarl, which is required to install pyproject.toml-based projects
具体子错误：error: --plat-name must be one of ('win32', 'win-amd64', 'win-arm32', 'win-arm64')

已确认pip为最新版本，且使用的Python3.10符合hikari官方支持的3.8-3.11版本范围。

解决方法 #

1. 安装C++编译环境 #

aiohttp等依赖需要C编译环境才能在Windows下构建轮子，直接安装Microsoft Visual C Build Tools：

• 下载微软官方的Build Tools安装程序，运行后勾选“C++构建工具”组件（包含MSVC编译器、Windows SDK等），完成安装后重启终端，再尝试执行安装命令。

2. 强制使用预编译二进制包（跳过本地编译） #

如果不想安装编译环境，可以让pip直接使用官方预编译的轮子，执行以下命令：

pip install hikari --only-binary :all:

这个参数会让pip优先下载预编译好的二进制包，避免本地编译环节，大概率能绕过这个错误。

3. 手动指定正确的平台名称 #

如果pip识别的平台名称有误，可手动指定：

• 先查看当前pip识别的平台信息：

pip debug --verbose

• 根据你的系统（32位用win32，64位用win-amd64），执行带平台参数的安装命令：

pip install hikari --global-option=build_ext --global-option="-plat-name=win-amd64"

• 也可以先设置环境变量修复distutils的问题：

set SETUPTOOLS_USE_DISTUTILS=stdlib

设置完成后再执行原安装命令。

4. 确认虚拟环境的有效性 #

确保当前激活的虚拟环境确实是基于Python3.10的，执行以下命令验证：

python --version
pip --version

如果版本不匹配，重新创建并激活正确版本的虚拟环境后再尝试安装。

内容的提问来源于stack exchange，提问作者NUBZRCOOL