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
- 强制pip仅拉取预编译wheel包安装两个触发编译错误的依赖:
第二优先级:补全已安装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
相关产品推荐
相关产品推荐

