萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Python pip 安裝 lxml 失敗?Windows/Linux 完整解決方案

前言

lxml 是 Python 高效的 XML/HTML 解析庫,但因依賴 C 擴展(libxml2、libxslt),pip install lxml 常因缺少編譯工具或系統函式庫而報錯。本文針對 Windows 與 Linux 兩大平台,提供經實測可行的完整解決方案。

一、常見錯誤現象

Building lxml version 4.x.x
Building without Cython.
ERROR: b"'xslt-config' 找不到..."
** make sure the development packages of libxml2 and libxslt are installed **
...
error: Unable to find vcvarsall.bat

核心原因:缺少 C 編譯器(Windows)或系統開發套件。

二、Windows 環境解決方案(推薦順序)

方案 1:使用預編譯 Wheel(最快、最穩)

  1. 確認 Python 版本與位元:python -c "import sys; print(sys.version, sys.maxsize > 2**32)"
  2. 至 Gohlke 網站下載對應 .whl 檔(如 lxml-4.9.1-cp310-cp310-win_amd64.whl)
  3. 安裝:pip install 下載路徑\lxml-xxx.whl

方案 2:安裝 Microsoft Visual C++ Build Tools

  1. 下載 Build Tools for Visual Studio
  2. 安裝時勾選 「C++ 建置工具」 及 「Windows 10 SDK」
  3. 重新開啟終端機,執行 pip install lxml

方案 3:使用 Conda(Anaconda/Miniconda 用戶)

conda install -c conda-forge lxml

Conda 會自動處理二進位相依,免編譯。

三、Linux 環境解決方案

Debian/Ubuntu 系列

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

CentOS/RHEL/Fedora 系列

sudo yum install -y python3-devel libxml2-devel libxslt-devel zlib-devel
# 或 dnf
sudo dnf install -y python3-devel libxml2-devel libxslt-devel zlib-devel
pip install lxml

Alpine Linux

apk add --no-cache python3-dev libxml2-dev libxslt-dev zlib-dev gcc musl-dev
pip install lxml

四、驗證安裝

python -c "from lxml import etree; print(etree.LXML_VERSION)"
# 輸出範例:(4, 9, 1, 0)

五、進階技巧

  • 加速安裝:pip install --no-build-isolation lxml 可跳過隔離建置,利用系統已安裝的庫。
  • 離線安裝:先在有網機器 pip download lxml,再離線 pip install --no-index --find-links=./ lxml。
  • 版本鎖定:pip install 'lxml==4.9.1' 避免自動升級導致相容性問題。

結語

Windows 建議直接下載 Wheel 或用 Conda,避免自行編譯;Linux 則務必先安裝 libxml2-dev、libxslt-dev 等開發套件。照著本文步驟操作,pip install lxml 將不再是攔路虎,助你專注於資料解析本身。

copyright © 萬盛學電腦網 all rights reserved