简介：libxslt-1.1.32 .tar.gz 是 XSLT 的 C 语言实现库源码包，面向需要处理 XML 文档转换的开发者与运维人员，可解决 XML 到 HTML、PDF、纯文本等格式的样式表转换需求。包内共约 2000 个文件，以 xsl 样式表、xml 输入样例、out 与 html 转换结果为主，辅以 c 与 h 源码、am 与 m4 构建脚本、dtd 与 ent 实体定义、fo 排版模板及 png、gif 等文档配图，压缩包约 3.28MB，目录结构完整，便于对照测试用例理解转换流程。该资源已有 469 人学习下载，适合希望深入 XSLT 1.0 与 XPath 1.0 规范、研究扩展函数与内置模板机制的读者。借助其中的源码、测试样例与构建脚本，读者可掌握编译安装、xsltproc 命令行调用及错误排查思路，为 Web 动态内容生成、系统间数据交换与文档批量转换等场景打下实践基础。
1. 编译 libxslt-1.1.32 之前，先把这套依赖链捋清楚
上周帮一个做文档转换的同事收拾环境，他要在内网一台老 CentOS 7 上跑一套 XML 样式表处理流程，结果./configure一跑就报找不到 libxml2 的 pkg-config 文件，折腾一下午没进展。这类问题太常见了：libxslt-1.1.32 本身不大，但它对 libxml2 的版本、头文件路径、pkg-config 搜索路径都有要求，装不好就是一连串configure: error和运行时undefined symbol。这篇笔记按我实际部署的顺序写，从版本选择、依赖准备、编译参数、安装后验证到翻车救援，适合需要在内网或离线环境手工编译 libxslt 的开发者照着走。源码包是libxslt-1.1.32.tar.gz，下面所有步骤都围绕这个版本展开。
2. 环境准备与版本选择：libxslt-1.1.32 依赖什么
2.1 先确认 libxml2 的版本和安装位置
libxslt 和 libxml2 是强绑定关系，1.1.32 这个版本对 libxml2 的最低要求是 2.6.27，但实际部署里我一般要求 2.9.x 以上，太老的 libxml2 在解析某些 XSLT 时会出兼容问题。装之前先查系统里有没有、在哪：
# 查 pkg-config 能否找到 libxml2，以及版本号 pkg-config --modversion libxml-2.0 pkg-config --cflags --libs libxml-2.0 # 如果系统包管理器装过，再看头文件和库的实际路径 ls /usr/include/libxml2/libxml/parser.h ls /usr/lib64/libxml2.so*第一条命令有输出且版本不低于 2.9.0，说明系统里已有可用的 libxml2 开发包，后面编译可以直接复用。如果报Package libxml-2.0 was not found，要么没装开发包（libxml2-devel），要么装在了非标准路径而 pkg-config 不知道。常见做法是优先用系统包管理器补开发包，内网离线机器则手工编译 libxml2 到/usr/local下，再用PKG_CONFIG_PATH指过去。这里有个取舍：系统自带的 libxml2 走/usr/lib64，手工编译的走/usr/local/lib，两套混用最容易在链接阶段翻车，所以要么全用系统的，要么全用手工的，别一半一半。
2.2 编译工具链和可选依赖清单
除了 libxml2，编译 libxslt 还需要一套基础工具链。我一般先跑一遍检查，缺什么补什么：
# 基础编译工具 gcc --version make --version # pkg-config 必须有，configure 靠它找 libxml2 pkg-config --version # 可选：libgcrypt 用于 EXSLT 加密扩展，zlib 用于压缩输出 pkg-config --modversion libgcrypt 2>/dev/null || echo "no libgcrypt" pkg-config --modversion zlib 2>/dev/null || echo "no zlib"gcc 版本不用太新，4.8 以上都能编 1.1.32，CentOS 7 自带的 4.8.5 实测没问题。libgcrypt 和 zlib 是可选依赖，不装也能编过，只是 EXSLT 里涉及加密和压缩的扩展函数不可用。如果你的 XSLT 里用到了exsl:document之外的加密扩展，才需要补 libgcrypt；普通文档转换用不上，我一般跳过以减少依赖面。工具链里最容易漏的是make之外的autoconf系列——1.1.32 的发布包已经带好了 configure 脚本，不需要重新 autoreconf，但如果从 git 拉源码就得补 autoconf、automake、libtool，这点要分清。
2.3 目录规划：prefix 定在哪，后面全跟着它走
编译前先想清楚装到哪。我习惯把手工编译的库统一放/usr/local/libxslt-1.1.32，再软链到/usr/local，这样多版本共存时好切换，卸载也干净：
# 建独立安装目录，避免和系统包混在一起 mkdir -p /usr/local/libxslt-1.1.32 # 源码解压到临时工作区 mkdir -p /opt/build && cd /opt/build tar -xzf libxslt-1.1.32.tar.gz cd libxslt-1.1.32--prefix一旦定了，后面configure、make install、运行时LD_LIBRARY_PATH全要跟它对齐。定在/usr/local最省事，但和系统包管理器装的 libxslt 容易冲突；定在独立目录则要多配一步动态库路径。我选独立目录是因为这台机器上还跑着别的依赖系统 libxslt 的服务，不能动/usr/lib64下的东西。如果你的机器干净、只跑这一套，直接--prefix=/usr/local更省心。
3. 编译安装 libxslt-1.1.32：configure 参数逐个说清
3.1 configure 阶段：把 libxml2 路径喂对
进入解压后的源码目录，核心是让 configure 找到正确的 libxml2。如果 libxml2 在标准路径，直接跑就行；在非标准路径，用PKG_CONFIG_PATH和--with-libxml-prefix双保险：
cd /opt/build/libxslt-1.1.32 # 假设 libxml2 手工装在 /usr/local/libxml2-2.9.10 export PKG_CONFIG_PATH=/usr/local/libxml2-2.9.10/lib/pkgconfig:$PKG_CONFIG_PATH ./configure \ --prefix=/usr/local/libxslt-1.1.32 \ --with-libxml-prefix=/usr/local/libxml2-2.9.10 \ --without-python \ --disable-static逐项说明：--prefix是安装根目录，前面已定；--with-libxml-prefix告诉 configure 去哪找 libxml2 的头文件和库，比只靠 pkg-config 更稳，因为有些老版本 libxml2 的 pkg-config 文件里路径写得不全；--without-python是因为 1.1.32 的 Python 绑定只支持 Python 2，现在机器上基本是 Python 3，带上反而报错，除非你确实需要 Python2 绑定；--disable-static只生成动态库，减少体积，也避免静态链接时把 libxml2 的符号重复打进去。configure 跑完重点看最后几行，确认libxml2的版本和路径识别正确，出现checking for libxml-2.0 >= 2.6.27... yes才算过。
3.2 make 与 make install：并行编译和安装路径核对
configure 通过后编译本身不复杂，但有两个细节值得说：
# 并行编译，核数按机器来，老机器别开太高免得 OOM make -j$(nproc) # 安装前先 dry-run 看文件会落到哪，确认 prefix 没写错 make -n install | head -20 # 确认无误再真正安装 make installmake -j$(nproc)在 2 核老机器上就是-j2，libxslt 源码量不大，编译很快，开太高反而可能因为内存不足被 OOM killer 干掉，血泪经验是内存小于 2G 的机器老老实实-j1。make -n install是干跑，只打印不执行，用来核对安装路径——我见过 prefix 写成相对路径导致文件散落一地的翻车现场，这一步能提前拦住。安装完成后，库文件在$PREFIX/lib，头文件在$PREFIX/include，xsltproc命令行工具在$PREFIX/bin。
3.3 动态库路径配置：ldconfig 与 LD_LIBRARY_PATH 的取舍
装到非标准 prefix 后，系统默认找不到新库，运行xsltproc会报error while loading shared libraries: libxslt.so.1。两种解法：
# 方案一：写进 ld.so.conf 并刷新缓存，全局生效，推荐 echo "/usr/local/libxslt-1.1.32/lib" > /etc/ld.so.conf.d/libxslt-1.1.32.conf ldconfig ldconfig -p | grep libxslt # 方案二：只在当前 shell 生效，适合临时测试 export LD_LIBRARY_PATH=/usr/local/libxslt-1.1.32/lib:$LD_LIBRARY_PATH方案一改的是系统级配置，所有用户和进程都能找到库，适合正式部署；方案二只影响当前会话，退出即失效，适合先验证再决定。我一般先用方案二快速验证编译产物没问题，确认后再落方案一。注意ldconfig之后要用ldconfig -p | grep libxslt确认缓存里真的有这条记录，有时候 conf 文件写了但路径拼错，ldconfig 不报错只是静默跳过，这一步是核对黑匣子的关键。另外如果机器上同时有系统 libxslt，ldconfig -p会列出多条，运行时按缓存顺序取，必要时用LD_LIBRARY_PATH强制优先。
4. 避坑与排查：libxslt 编译安装常见问题
4.1 configure 报找不到 libxml2
现象：configure: error: libxml2 not found或checking for libxml-2.0... no。原因通常是 libxml2 开发包没装，或装了但 pkg-config 搜索路径不含它。解决：先pkg-config --modversion libxml-2.0确认，找不到就补libxml2-devel（系统包）或手工编译 libxml2 后用PKG_CONFIG_PATH指过去，同时加--with-libxml-prefix兜底。别只改一个，两个一起配最稳。
4.2 编译通过但运行报 undefined symbol
现象：xsltproc能启动，处理样式表时报undefined symbol: xmlXPath...。原因是编译时链接的 libxml2 和运行时加载的 libxml2 不是同一份，版本或路径错位。解决：用ldd $(which xsltproc) | grep xml看实际加载的库路径，和编译时--with-libxml-prefix指的路径比对，不一致就调整LD_LIBRARY_PATH或 ldconfig 顺序，确保编译期和运行期用同一套 libxml2。
4.3 make install 后 xsltproc 命令找不到
现象：xsltproc: command not found。原因是 prefix 的 bin 目录不在 PATH 里。解决：export PATH=/usr/local/libxslt-1.1.32/bin:$PATH，要持久化就写进/etc/profile.d/下的脚本。注意别把整个 prefix 加进 PATH，只加 bin 子目录，否则容易和系统命令混淆。
4.4 Python 绑定编译失败
现象：configure阶段报 Python 相关错误，或make时 Python 模块编译不过。原因是 1.1.32 的 Python 绑定面向 Python 2，机器上是 Python 3。解决：加--without-python跳过，绝大多数文档转换场景用不上 Python 绑定，真需要就用 Python 的 lxml 库，它内部自带 libxslt，不必手工编绑定。
4.5 多版本 libxslt 冲突
现象：系统里已有 libxslt，新装的版本不生效，或反过来把系统服务搞挂。原因是 ldconfig 缓存顺序和 SONAME 相同导致覆盖。解决：手工编译的版本装独立 prefix，运行时用LD_LIBRARY_PATH显式指定，不要往/usr/lib64里覆盖；ldconfig -p | grep libxslt确认有多条时，靠环境变量控制优先级，别依赖默认顺序。
5. 装完怎么验证：xsltproc 跑通一个最小样式表
编译安装完不能只看make install没报错就收工，得实际跑一遍转换。我一般准备两个最小文件：一个 XML 数据，一个 XSLT 样式表，用xsltproc转出结果比对。
# 建验证目录 mkdir -p /tmp/xslt-check && cd /tmp/xslt-check # 最小 XML 输入 cat > input.xml <<'EOF' <?xml version="1.0"?> <root><item id="1">alpha</item><item id="2">beta</item></root> EOF # 最小 XSLT：把 item 转成带序号的文本 cat > style.xsl <<'EOF' <?xml version="1.0"?> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> <xsl:output method="text"/> <xsl:template match="/"> <xsl:for-each select="root/item"> <xsl:value-of select="@id"/>:<xsl:value-of select="."/> </xsl:for-each> </xsl:template> </xsl:stylesheet> EOF # 执行转换，指定新装的 xsltproc /usr/local/libxslt-1.1.32/bin/xsltproc style.xsl input.xml预期输出是1:alpha2:beta。如果输出为空或报错，先看xsltproc --version打印的 libxml2 和 libxslt 版本号是否和预期一致，再用ldd核对动态库路径。这一步能同时验证三件事：二进制能启动、动态库链接正确、XSLT 引擎实际工作。我还会顺手跑一个带exsl:node-set的样式表，确认 EXSLT 扩展可用，因为很多实际项目依赖它做多遍处理。
验证通过后，把版本信息记一笔：xsltproc --version会输出类似Using libxml 20910, libxslt 10132的内容，10132 对应 1.1.32，20910 对应 libxml2 2.9.10，两个数字对得上才算这套环境真正落地。从那以后我每次手工编译这类有强依赖的库，都强制先跑一遍最小样例再交付，光看安装日志通过不算数。希望帮到你。
本文还有配套的精品资源，点击获取
