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

解决 pip 子进程安装构建依赖时出现的错误
当执行 pip install 时，如果遇到 subprocess-exited-with-error (exit code 1) 报错，通常是因为某些依赖项无法正常编译或安装。以下是几种可能的原因及其解决方案：
1. Setuptools 版本不兼容
该问题可能是由 setuptools 的版本过高或过低引起。可以通过调整其版本来解决问题。

升级 setuptools 到最新版本：
pip install --upgrade setuptools
登录后复制

如果升级后仍然存在问题，则可以尝试降级到特定版本（例如 65.x），因为高版本可能导致部分包不兼容：
pip install setuptools==65.0.0
登录后复制
此方法已被验证能够解决许多类似的安装失败问题[^1]。

2. 依赖冲突
有时目标包与其他已安装的包存在版本冲突，这可能会导致构建过程中的错误。

尝试忽略依赖关系并强制安装目标包：pip install <package_name> --no-dependencies
登录后复制
这种方法适用于那些不需要严格依赖其他组件的情况[^3]。

3. Python 或环境配置问题
确保当前使用的 Python 环境支持所要安装的包。例如，某些 C 扩展模块需要对应的开发工具链才能完成编译。

安装必要的编译工具和库文件（Linux 用户可运行以下命令）：
sudo apt-get update &amp;&amp; sudo apt-get install -y build-essential libssl-dev libffi-dev python3-dev
登录后复制

对于 Windows 用户，建议下载 Microsoft Build Tools 并确保 Visual Studio 已正确安装相关工作负载。

4. 镜像源设置不当
更改默认 PyPI 镜像源也可能引发此类问题。例如，使用百度镜像时可能出现异常行为。

清除现有全局配置：
pip config unset global.index-url
登录后复制

使用官方推荐的方式重新指定国内常用镜像之一（如阿里云）：
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
登录后复制
上述操作有助于排除因网络连接不稳定而导致的子进程退出错误[^4]。

5. 清理缓存数据
旧版缓存残留也有可能干扰新版本程序的正常加载流程。
清除本地 Pip 缓存目录下的所有内容后再重试即可：
pip cache purge
登录后复制
或者手动删除路径下对应文件夹(视操作系统而定)，之后再执行原指令看效果如何变化。

总结
综上所述，针对 pip subprocess-exited-with-error exit code 1 这类常见错误现象，可以从多个角度出发逐一排查原因直至找到最合适的修复方案为止。具体措施包括但不限于更新/回滚 Setuptools 组件、规避潜在相互作用影响以及优化外部条件设定等方面入手加以改进处理。