错误源于缺少libxml2和libxslt开发库，需按系统安装对应dev包：Ubuntu/Debian用sudo apt-get install libxml2-dev libxslt1-dev python3-dev build-essential；CentOS/RHEL用sudo yum install libxml2-devel libxslt-devel python3-devel gcc；macOS先xcode-select --install；Windows则应下载匹配的预编译whl文件安装。
pip install lxml 报错，基本不是命令写错了，而是底层依赖、环境错位或平台限制导致的。直接重试 pip install lxml 通常无效，必须按系统类型和错误现象对症处理。
报错含 “libxml2/libxslt development packages are installed” 或编译失败
这是 Linux/macOS 最常见的情况，本质是缺少 C 编译所需的头文件和开发库，不是 Python 包本身的问题。- Ubuntu/Debian 系统运行：
sudo apt-get install -y libxml2-dev libxslt1-dev python3-dev build-essential
- CentOS/RHEL 系统运行：
sudo yum install -y libxml2-devel libxslt-devel python3-devel gcc
- macOS 运行：
xcode-select --install
然后再执行pip install lxml
注意：如果用的是 Apple Silicon（M1/M2/M3）芯片 Mac，且 Python 是 arm64 架构，确保安装的 libxml2 和 libxslt 也是 arm64 版本（Homebrew 默认满足）；若混用 x86_64 Python，会因架构不匹配继续失败。
Windows 下报 “Microsoft Visual C++ 14.0” 或 “Failed building wheel”
Windows 没有预装 C++ 构建工具，源码编译必然失败。别硬刚，直接用预编译 wheel。- 先确认 Python 版本和架构：
python -c "import platform; print(platform.architecture(), platform.machine())"
- 去 https://www.php.cn/link/55fa6b030b5add10de4e5c8d6ae8b5ff 找对应 wheel 文件，例如：
lxml‑5.3.0‑cp312‑cp312‑win_amd64.whl（Python 3.12，64 位 Windows） - 下载后本地安装：
pip install lxml‑5.3.0‑cp312‑cp312‑win_amd64.whl
国内访问慢？换清华源：
百度文档解析pipeline-parser
下载
调用百度文档解析API，支持18+格式，提取文本、表格、版面分析、OCR识别及RAG文档分块。适用于文档解析、文本/表格提取、结构分析、扫描件处理。触发词：文档解析、PDF解析、Word解析、表格提取、OCR、文档分析、提取文本、文档结构、扫描识别。
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ lxml‑5.3.0‑cp312‑cp312‑win_amd64.whl
明明装了却 import lxml 报 ModuleNotFoundError
这说明pip 安装的环境和你运行 Python 的解释器不是同一个。
- 检查当前 Python 解释器路径：
which python
（Linux/macOS）或where python
（Windows） - 检查 pip 对应的 Python：
pip show pip
看 “Location” 路径，对比是否和上面一致 - PyCharm 用户特别注意：右下角解释器设置是否指向你用 pip 安装的那个环境？不是项目默认新建的虚拟环境，也不是系统 Python
常见坑：在终端用 python3 -m pip install lxml，但 IDE 里跑的是 python（即 Python 2），或者反过来。
Python 3.12+ 或较新版本安装失败
PyPI 上 wheel 发布常滞后于 Python 新版发布。比如 Python 3.12 刚出时，很多lxml 版本还没提供 cp312 标签的 wheel。
- 查看可用 wheel：
pip index versions lxml
- 若无匹配版本，降级到已支持的最近版，例如：
pip install lxml==5.2.2
- 或等官方更新（一般 1–4 周内会补全）
最稳妥做法：始终用 pip install --only-binary=lxml lxml 强制跳过源码编译，只装 wheel —— 这能避开 90% 的编译类报错。
真正卡住的地方，往往不是“怎么装”，而是没意识到 pip、python、IDE 解释器、虚拟环境四者可能各走各路。先对齐执行环境，再谈装什么。
