Installing build dependencies ... error error: subprocess-exited-with-error × pip subprocess to install build dependencies did not run successfully. │ exit code: 1 ╰─> [78 lines of output] Looking in indexes: https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple Ignoring numpy: markers 'python_version == "3.5"' don't match your environment Ignoring numpy: markers 'python_version == "3.6"' don't match your environment Ignoring numpy: markers 'python_version == "3.7"' don't match your environment Collecting setuptools Using cached https://mirrors.tuna.tsinghua.edu.cn/pypi/web/packages/a9/38/7d7362e031bd6dc121e5081d8cb6aa6f6fedf2b67bf889962134c6da4705/setuptools-75.8.2-py3-none-any.whl (1.2 MB) Collecting wheel Using cached https://mirrors.tuna.tsinghua.edu.cn/pypi/web/packages/0b/2c/87f3254fd8ffd29e4c02732eee68a83a1d3c346ae39bc6822dcbcb697f2b/wheel-0.45.1-py3-none-any.whl (72 kB) Collecting scikit-build Using cached https://mirrors.tuna.tsinghua.edu.cn/pypi/web/packages/c3/a3/21b519f58de90d684056c52ec4e45f744cfda7483f082dcc4dd18cc74a93/scikit_build-0.18.1-py3-none-any.whl (85 kB) Collecting cmake Downloading https://mirrors.tuna.tsinghua.edu.cn/pypi/web/packages/18/58/909d6d99acb4e0886d0f660cf4e0fb26f586590e370b2e4ce7a10d06b145/cmake-3.31.6-py3-none-win_amd64.whl (36.4 MB) -------------------------------------- 36.4/36.4 MB 177.3 kB/s eta 0:00:00 Collecting pip Downloading https://mirrors.tuna.tsinghua.edu.cn/pypi/web/packages/c9/bc/b7db44f5f39f9d0494071bddae6880eb645970366d0a200022a1a93d57f5/pip-25.0.1-py3-none-any.whl (1.8 MB) ---------------------------------------- 1.8/1.8 MB 308.2 kB/s eta 0:00:00 Collecting numpy==1.17.3 Downloading https://mirrors.tuna.tsinghua.edu.cn/pypi/web/packages/b6/d6/be8f975f5322336f62371c9abeb936d592c98c047ad63035f1b38ae08efe/numpy-1.17.3.zip (6.4 MB) --------------------------------------
时间: 2025-04-24 20:01:47 浏览: 152
### 解决 `pip` 安装构建依赖时报错 `subprocess-exited-with-error`
当遇到 `error: subprocess-exited-with-error` 错误时,通常是因为某些包的安装过程中出现了问题。此错误可能由多种原因引起,包括但不限于 setuptools 版本不兼容、环境配置不当或其他软件冲突。
#### 方法一:更新或降级 `setuptools`
该错误的一个常见原因是 `setuptools` 的版本过高或过低,与正在尝试安装的库存在兼容性问题。可以通过调整 `setuptools` 的版本来解决问题:
```bash
pip uninstall setuptools
pip install setuptools==65.5.0 # 或者其他适合的版本号
```
如果不确定哪个版本合适,则可以从较新的稳定版开始测试,逐步回退直到找到能正常工作的版本[^2]。
#### 方法二:升级 Python 和 pip 到最新版本
有时旧版本的 Python 或 pip 可能会引发此类问题。确保使用的是最新的 Python 发行版以及对应的 pip 工具可以帮助避免许多潜在的问题:
```bash
python -m ensurepip --upgrade
pip install --upgrade pip
```
对于 Windows 用户来说,命令中的 `python` 应替换为具体的解释器路径如 `py` 或带有完整路径的形式;而对于 macOS/Linux 用户,默认情况下可以直接调用 `python` 命令[^1]。
#### 方法三:清理缓存并重试
有时候本地缓存文件损坏也会造成类似的错误提示,在这种情况下清除 pip 缓存再重新执行安装操作可能会有所帮助:
```bash
pip cache purge
# 或者更早版本中使用的命令
# pip reset
```
之后再次运行原来的 `pip install` 指令看看是否能够顺利完成安装过程。
#### 方法四:指定编译工具链
部分 C/C++ 扩展模块在不同平台上需要特定版本的编译器支持才能成功编译。比如在 Windows 上安装某些扩展时就需要 Visual Studio Build Tools 提供必要的 MSVC 编译器组件。因此确认目标平台已正确安装所需开发工具也是排除这类故障的关键步骤之一。
### 注意事项
- 如果是在虚拟环境中工作,请先激活相应的 virtualenv 后再按照上述建议操作。
- 对于那些频繁变动且容易出现问题的第三方库,考虑直接从源码仓库克隆项目并通过 setup.py 来完成安装也是一个不错的选择。
阅读全文
相关推荐



















