完美解决pip安装包时的Python报错：error: subprocess-exited-with-error

🧑 博主简介：阿里巴巴嵌入式技术专家，深耕嵌入式+人工智能领域，具备多年的嵌入式硬件产品研发管理经验。

📒 博客介绍：分享嵌入式开发领域的相关知识、经验、思考和感悟，欢迎关注。提供嵌入式方向的学习指导、简历面试辅导、技术架构设计优化、开发外包等服务，有需要可加文末联系方式联系。

💬 博主粉丝群介绍：① 群内高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

目录

• • 问题背景
  • • 错误示例代码
    • 完整报错内容
    • 解决方法
    • • 1. 更新软件包列表并安装所需的编译工具和库
      • • 对于 Ubuntu/Debian 系统：
        • 对于 CentOS/RHEL 系统：
        • 对于 macOS 系统：
      • 2. 重新尝试安装 `lxml`
    • 示例与应用
    • • 示例 1：安装编译依赖以解决错误
      • 示例 2：在虚拟环境中隔离安装依赖
      • 示例 3：使用镜像源以确保更快的下载速度
      • 示例 4：使用预编译的二进制包（终极解决方案，强烈推荐）
    • 总结

问题背景

error: subprocess-exited-with-error 通常是 pip 在执行过程中调用外部命令的子进程时遇到错误导致的。这类错误信息通常包含以下几个常见原因：

编译过程中缺少依赖：安装某些需要编译的 Python 包时，系统可能缺少某些依赖。
权限问题：某些需要超级用户权限的操作没有使用 sudo 进行。
网络问题：下载包或者其依赖过程中遇到网络错误。
特定包的问题：某些包本身可能存在特定的问题，导致安装失败。

错误示例代码

假设你在命令行中运行以下命令来安装 lxml 包：

pip install lxml 

完整报错内容

报错内容可能会类似于以下内容：

Building wheels for collected packages: lxml Building wheel for lxml (setup.py) … error error: subprocess-exited-with-error python setup.py bdist_wheel did not run successfully. note: This error originates from a subprocess, and is likely not a problem with pip. ERROR: Failed building wheel for lxml error: legacy-install-failure Encountered error while trying to install package. note: This is an issue with the package mentioned above, not pip. hint: See above for output from the failure. 

解决方法

这个报错通常是由于缺少编译依赖，在安装需要编译的 Python 包时，需要先安装某些系统级依赖。以下是更详细的解决步骤和示例代码。

1. 更新软件包列表并安装所需的编译工具和库

对于 Ubuntu/Debian 系统：

sudo apt-get update sudo apt-get install -y build-essential python3-dev libxml2-dev libxslt1-dev zlib1g-dev 

对于 CentOS/RHEL 系统：

sudo yum groupinstall 'Development Tools' sudo yum install -y python3-devel libxml2-devel libxslt-devel zlib-devel 

对于 macOS 系统：

安装 Xcode 命令行工具：

xcode-select --install brew install libxml2 libxslt 

2. 重新尝试安装 lxml

pip install lxml 

示例与应用

以下是一些具体的解决方案例子，展示如何应对和解决此类生成失败的错误。

示例 1：安装编译依赖以解决错误

sudo apt-get update sudo apt-get install -y build-essential python3-dev libxml2-dev libxslt1-dev zlib1g-dev pip install lxml 

输出示例：

Collecting lxml   Using cached lxml-4.9.1.tar.gz (3.4 MB)   Preparing metadata (setup.py) ... done Building wheels for collected packages: lxml   Building wheel for lxml (setup.py) ... done   Created wheel for lxml: filename=lxml-4.9.1-cp39-cp39-linux_x86_64.whl size=1457894 sha256=b38a2781e8e19a4bb7628d6a1bbd3729f36f13b0c22c2745b8442df83e532d88   Stored in directory: /root/.cache/pip/wheels/ec/92/15/dcfd0023606abd37fdb1a6a58528784e40f3eadf8df6a0e610 Successfully built lxml Installing collected packages: lxml Successfully installed lxml-4.9.1 

示例 2：在虚拟环境中隔离安装依赖

创建并激活一个新的虚拟环境：

python -m venv myenv source myenv/bin/activate  # 在 Windows 上使用 myenv\Scripts\activate  # 安装所需的编译依赖 sudo apt-get update sudo apt-get install -y build-essential python3-dev libxml2-dev libxslt1-dev zlib1g-dev  # 在虚拟环境中安装 lxml pip install lxml 

示例 3：使用镜像源以确保更快的下载速度

pip install lxml -i https://pypi.tuna.tsinghua.edu.cn/simple 

示例 4：使用预编译的二进制包（终极解决方案，强烈推荐）

有些包提供了预编译的二进制版本，可以通过 wheel 来安装，避免编译问题：

pip install lxml --use-wheel 

如果预编译版本不可用，尝试手动下载并安装：

1. 从 Python官方包索引(PyPI) 下载对应平台的 .whl 文件。
2. 使用 pip 安装这个文件：

pip install lxml-4.9.1-cp39-cp39-manylinux1_x86_64.whl 

总结

出现 subprocess-exited-with-error 错误通常是由于缺少编译依赖或者系统环境配置不当。在安装需要编译的 Python 包（如 lxml）时，通过安装必要的编译工具和库、使用虚拟环境隔离依赖、尝试使用镜像源以及使用预编译的二进制包，可以有效地解决这些问题。

希望这些示例和解决方案能帮助你解决这个问题。如果有其他问题或需要进一步的帮助，欢迎在评论区留言讨论！