× Getting requirements to build wheel did not run successfully. │ exit code: 1 ╰─> See above for output.

当尝试构建wheel（一种Python模块的二进制分发格式）时，出现了错误，显示了exit code: 1，这意味着命令执行失败。这通常是因为缺少某些必需的软件包（requirements）或者遇到了安装过程中的其他问题，比如权限限制、网络问题或是依赖版本不兼容等。查看上述输出（"See above for output."）是为了寻找更详细的错误信息，如错误消息、缺失的依赖列表或其他有用的提示。

要修复这个问题，你可以按照下面步骤操作：

1. 检查requirements.txt文件，确认所有需要安装的包都已包含并正确指定。
2. 清理并重新创建虚拟环境，以避免环境混乱影响到轮子的生成。
3. 确保所有依赖项都已成功安装，可能需要手动安装缺失的依赖。
4. 检查是否有权限问题，确保有正确的权限访问目录来安装和构建轮子。
5. 如果是网络问题，尝试切换到稳定的网络环境再运行。

相关问题

error: subprocess-exited-with-error × Getting requirements to build wheel did not run successfully. │ exit code: 1 ╰─> See above for output.

### 解决 `subprocess-exited-with-error` 错误的方法

当遇到 `pip install` 过程中的错误提示 `subprocess-exited-with-error × python setup.py egg_info did not run successfully.` 或者 `getting requirements to build wheel failed` 时，这通常意味着在尝试构建包的过程中出现了问题。以下是几种可能的原因和解决方案：

#### 更新工具链版本
确保使用的 Python 和 pip 是最新版本可以减少许多兼容性问题。可以通过以下命令更新这些工具：

python -m pip install --upgrade pip setuptools wheel

#### 安装缺失的编译器和其他依赖项
某些软件包需要特定的编译环境才能成功安装。对于 Windows 用户来说，Visual C++ Build Tools 可能是必需的；而对于 Linux 用户，则需确认已安装 gcc 等开发库。

#### 使用预编译二进制文件代替源码分发版
如果项目提供了 wheels 文件（即预先打包好的二进制发行版），那么可以直接下载并安装它们来避开本地编译的需求。可以在 PyPI 上查找是否有可用的轮子文件，或者通过指定平台标签的方式让 pip 自动寻找适合当前系统的 wheel 版本[^1]。

#### 设置环境变量或配置参数
有时设置一些特殊的环境变量也可以帮助解决问题。比如，在 Unix-like 系统上可以尝试设置 `PYTHONPATH` 来指向正确的路径，或者是调整 `CFLAGS`, `LDFLAGS` 等编译选项以便更好地匹配目标架构的要求。

#### 调试与日志记录
为了更深入地了解具体发生了什么情况，开启详细的调试模式有助于定位根本原因。使用 `-v` 参数可以让 pip 输出更多的信息用于排查故障：

pip install <package_name> -v

error: subprocess-exited-with-error × Getting requirements to build wheel did not run successfully. │ exit code: 1 ╰─> See above for output. note: This error originates from a subprocess, and is likely not a problem with pip.

这个错误通常是由于缺少依赖项或环境问题导致的。以下是一些可能有用的解决方法：

1. 确保您的操作系统和 Python 版本都是最新的。有时，此错误可能是由于旧版本的依赖项不兼容而引起的。

2. 确保您安装了正确的依赖项。您可以在项目的文档中找到所需的依赖项列表，并确保已将其全部安装。有时，缺少依赖项会导致此错误。

3. 尝试在虚拟环境中安装包。通过使用虚拟环境，可以确保您的包安装在独立的环境中，而不会与其他包产生冲突。

4. 确保您的计算机上安装了必要的构建工具。有些包需要 C 编译器和其他构建工具才能安装。您可以在操作系统的软件包管理器中查找这些工具，并确保它们已安装。

5. 如果您使用的是 Windows 操作系统，请确保已正确配置环境变量。有时，Windows 系统需要手动配置 PATH 和其他环境变量才能正确安装和使用一些包。

6. 如果以上方法都不起作用，请尝试使用 `--no-cache-dir` 参数重新安装包。有时，缓存可能会导致包安装失败，这时候可以尝试清除缓存并重新安装。

如果您还遇到问题，请查看完整的错误消息以获取更多详细信息，并尝试在互联网上寻找类似问题的解决方案。