执行pip install docx命令报错，该如何解决？

错误原因 #

该错误是安装python-docx的依赖库lxml时，本地缺少编译所需的系统级依赖（libxml2、libxslt），导致编译过程失败。

解决步骤 #

方法一：使用预编译包（推荐，无需编译） #

直接让pip下载预编译的lxml二进制包，跳过编译步骤：

pip install lxml --only-binary :all:

完成后再安装python-docx：

pip install python-docx

方法二：安装系统依赖后编译 #

如果需要本地编译lxml，以Mac系统为例，使用Homebrew完成以下步骤：

1. 安装编译所需的系统库：

brew install libxml2 libxslt

2. 指定依赖路径编译安装lxml：

pip install lxml --global-option=build_ext --global-option="-I$(brew --prefix libxml2)/include/libxml2" --global-option="-L$(brew --prefix libxml2)/lib" --global-option="-L$(brew --prefix libxslt)/lib"

3. 最后安装python-docx：

pip install python-docx

方法三：使用虚拟环境规避系统Python问题 #

如果使用系统Python出现权限或路径冲突，建议创建虚拟环境后再安装：

# 创建并激活虚拟环境
python3 -m venv docx-env
source docx-env/bin/activate
# 安装python-docx
pip install python-docx

内容的提问来源于stack exchange，提问作者Sugar719