解决 discord.py 安装失败：轮子构建错误与Python兼容性指南

在python开发中，尤其是在windows环境下安装带有c扩展的库时，开发者经常会遇到“failed building wheel”的错误。当尝试安装discord.py时，如果其依赖库如aiohttp的子依赖frozenlist和multidict无法成功构建轮子（wheel），就会导致安装失败。这类问题通常源于两个主要原因：python版本不兼容，或者缺少必要的编译工具。

1. Python 版本兼容性检查与调整

discord.py及其核心依赖对Python版本有特定的要求。安装discord.py==2.3.2时，其官方支持的Python版本为3.8、3.9和3.10。如果您的Python环境版本过新（例如Python 3.11或3.12），则很可能导致某些依赖库无法找到预编译的轮子文件，从而尝试在本地编译，进而引发构建失败。

如何检查您的Python版本：

打开终端或命令提示符，输入以下命令：

python --version
# 或者在Windows上可能需要
py -3 --version

输出将显示当前环境中默认的Python版本，例如Python 3.12.0。

立即学习“Python免费学习笔记（深入）”；

解决方案：

如果您的Python版本不在discord.py 2.3.2支持的3.8、3.9、3.10范围内，建议您采取以下措施：

• 创建新的虚拟环境并指定兼容的Python版本： 这是最推荐的做法。虚拟环境可以隔离项目依赖，避免版本冲突。 在PyCharm中，您可以在创建新项目或配置解释器时，选择一个已安装的兼容Python版本，或通过PyCharm下载并配置一个。 如果手动创建虚拟环境，可以使用以下命令：

  # 例如，使用Python 3.9创建虚拟环境
  # 确保您系统上已安装Python 3.9
  python3.9 -m venv my_discord_bot_env
  # 激活虚拟环境
  # Windows
  .\my_discord_bot_env\Scripts\activate
  # macOS/Linux
  source my_discord_bot_env/bin/activate

  登录后复制

  激活虚拟环境后，再尝试安装discord.py。

• 降级或切换系统Python版本（不推荐作为首选）： 如果您不使用虚拟环境，可能需要降级或切换系统默认的Python版本。但这可能会影响到其他依赖特定Python版本的项目，因此不建议直接修改系统Python。

  

  挖错网

  一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

  28

  查看详情

2. 安装 Microsoft Visual C++ Build Tools

当Python无法找到某个库的预编译轮子（wheel）文件时，它会尝试从源代码编译该库。对于许多用C或C++编写的Python扩展（如frozenlist和multidict），在Windows系统上进行编译需要Microsoft Visual C++编译器。当您看到类似error: Microsoft Visual C++ 14.0 or greater is required的错误信息时，就表明缺少了这些编译工具。

解决方案：

1. 下载并安装 Microsoft C++ Build Tools： 访问官方下载页面：https://www.php.cn/link/2f93b699c738691d0b53d82ed1e25817
2. 选择安装工作负载： 下载并运行安装程序后，在“工作负载”选项卡中，勾选“使用C++的桌面开发”（Desktop development with C++）。确保安装过程中包含了必要的C++编译器组件。
3. 完成安装： 按照提示完成安装。安装过程可能需要一段时间。

安装完成后，您不需要对PyCharm或Python环境进行额外配置，pip将能够自动检测到并使用这些新安装的编译工具。

3. 重新尝试安装 discord.py

在确认Python版本兼容并已安装Microsoft Visual C++ Build Tools后，您可以再次尝试安装discord.py。

1. 激活您的虚拟环境（如果使用）：

   # Windows
   .\my_discord_bot_env\Scripts\activate
   # macOS/Linux
   source my_discord_bot_env/bin/activate

   登录后复制
2. 执行安装命令：

   pip install discord.py==2.3.2

   登录后复制

   或者，如果您想升级已安装的版本：

   pip install discord.py --upgrade

   登录后复制

此时，pip应该能够成功安装frozenlist和multidict，进而完成discord.py的安装。

注意事项

• 始终使用虚拟环境： 强烈建议为每个Python项目使用独立的虚拟环境。这有助于管理项目依赖，避免不同项目间的库版本冲突。
• 保持pip最新： 确保您的pip版本是最新，有时旧版本的pip可能无法正确处理某些依赖或构建过程。

  python -m pip install --upgrade pip

  登录后复制
• 查阅官方文档： 在遇到问题时，查阅discord.py的官方文档或GitHub仓库，了解其最新的Python版本支持信息和已知问题。
• 详细错误信息： 如果问题依然存在，仔细阅读终端输出的完整错误信息。即使是看似重复的错误，其中也可能包含新的线索。

总结

discord.py安装过程中遇到的“Failed building wheel”错误，特别是涉及frozenlist和multidict的，通常可以通过解决Python版本兼容性问题和安装Microsoft Visual C++ Build Tools来解决。首先确保您的Python版本在discord.py的支持范围内（对于2.3.2版本是3.8、3.9、3.10），其次在Windows系统上安装必要的C++编译工具。遵循这些步骤，将有助于您顺利安装discord.py并开始您的Discord机器人开发之旅。

以上就是解决 discord.py 安装失败：轮子构建错误与Python兼容性指南的详细内容，更多请关注php中文网其它相关文章！