error:subprocess-exited-with-error Getting requirements to build wheel did not run successfully exit code:1 [18 lines of output]

### 解决 pip 构建 wheel 子进程退出错误 exit code 1

当遇到 `exit code 1` 或者其他非零退出码时，通常意味着命令执行过程中出现了某种类型的失败。对于构建 wheel 的情况，可能的原因包括依赖项缺失、环境配置不当或是编译器工具链不兼容。

#### 检查并更新 Python 和 pip 版本
确保使用的 Python 及其包管理工具是最新的版本可以减少许多潜在的问题。可以通过以下方式来完成此操作：

python -m ensurepip --upgrade
python -m pip install --upgrade pip setuptools wheel

这会强制安装最新版的 pip, setuptools 和 wheel 工具[^2]。

#### 验证开发工具和库的存在
某些扩展模块（如 MySQL 客户端）在编译期间需要特定的操作系统级别的库支持。如果缺少这些必要的头文件或静态链接库，则会导致编译过程中的错误。针对 macOS 用户，在尝试安装 `mysqlclient` 前应先确认已通过 Homebrew 安装了 MySQL 开发资源以及 zstd 库:

brew install mysql
brew install zstd
export LDFLAGS="-L/usr/local/opt/zstd/lib"
export CPPFLAGS="-I/usr/local/opt/zstd/include"

上述设置将帮助定位到正确的路径以便于找到所需的外部函数声明和其他依赖关系[^3]。

#### 使用预编译二进制发行版代替源码分发
有时直接从 PyPI 下载官方发布的 .whl 文件要比本地重新编译更简单可靠。为了获取适用于当前平台架构的最佳匹配轮档，建议利用 `-f` 参数指定额外索引站点或者仅限于寻找适合系统的 binary 轮子：

pip install --only-binary :all: somepackage

这种方法能够绕过复杂的 C 扩展编译流程从而规避掉很多麻烦事[^1]。

#### 设置合适的权限与工作目录
OSError 类型的信息提示可能是由于权限不足或者是试图在一个不允许修改的位置运行脚本造成的。切换至具有适当读写访问权的工作区，并且赋予足够的权限给解释器及其关联组件有助于解决问题的发生。

---