You need to enable JavaScript to run this app. Windows下安装discord.py报错:无法构建multidict、yarl的PEP 517 wheel
优惠活动
大模型
产品
解决方案
定价
更多

Windows下安装discord.py报错:无法构建multidict、yarl的PEP 517 wheel

Windows 10下discord.py安装触发PEP517构建失败的解决方法

错误核心触发逻辑:pip 安装过程中拉取yarl 1.5.1、multidict 4.7.6的源码压缩包时,没有匹配到当前Python版本对应的Windows平台预编译wheel文件,就会触发本地源码编译流程;即便本地安装了Visual Studio 16版本,只要未勾选安装对应版本的MSVC C生成工具链,就会被判定为缺少要求的Microsoft Visual C 14.0+编译环境,最终弹出报错"Could not build wheels for multidict, yarl which use PEP 517 and cannot be installed directly"。

第一优先级:绕开本地编译流程,直接安装预编译依赖

这个方案不需要额外安装任何编译组件,是操作成本最低的解决方式:

  • 依次在命令提示符中执行以下命令:
    • 强制pip仅拉取预编译wheel包安装两个触发编译错误的依赖:pip install multidict==4.7.6 yarl==1.5.1 --only-binary=:all:
      • 命令中--only-binary=:all:参数会完全禁止pip执行本地源码编译逻辑,只要源上存在匹配当前Python3.9.0版本、Windows平台的对应依赖包,就会直接安装跳过编译环节
    • 上述依赖安装完成后,再执行discord.py的常规安装命令:pip install discord.py

第二优先级:补全已安装Visual Studio 16的缺失组件

如果强制拉取预编译包的操作失败,大概率是本地的Visual Studio 16没有安装被Python setuptools识别到的C++编译组件,按以下步骤补全即可:

  • 打开Visual Studio Installer,找到本地已安装的Visual Studio 16条目,点击“修改”进入配置页
  • 在“工作负载”标签页,勾选“使用C++的桌面开发”选项,确认右侧安装明细中选中以下核心组件:
    • MSVC v142 - VS 2019 C++ x64/x86 生成工具
    • 适配当前Windows10系统版本的Windows SDK
  • 组件安装完成后,必须关闭所有已经打开的命令提示符窗口,重新启动新的命令行窗口,再重新执行安装命令
    • 注意:旧命令行窗口的环境变量是在窗口启动时加载的,不会自动识别新装的编译组件路径,复用旧窗口会一直提示缺少编译环境。

备选方案:安装独立精简版C++生成工具

如果不想安装完整的Visual Studio 16,也可以直接安装微软发布的独立C++生成工具包:

  • 安装独立Build Tools包时,同样勾选上述MSVC v142生成工具、对应Windows10 SDK组件即可
  • 安装完成后重启命令行,重新执行依赖和discord.py的安装流程

避坑提醒

  • pip 本身不存在pip install --update、pip install -update、pip install update这类有效升级命令,正确的pip升级命令为python -m pip install --upgrade pip
  • 如果安装过程中仍然触发源码编译流程,优先检查当前命令行对应的Python解释器路径,确认和你安装的Python3.9.0路径完全匹配,避免因为多版本Python环境冲突,导致pip拉取不到对应版本的预编译wheel包。

内容的提问来源于stack exchange,提问作者ReKtYT

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 20:24:03