XSLT 元素参考手册（一文讲透）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在数据处理和文档转换领域，XSLT（可扩展样式表语言转换）是一个不可或缺的工具。它能够将XML数据转换为HTML、文本或其他格式，帮助开发者实现数据的灵活呈现。然而，对于许多编程初学者和中级开发者而言，XSLT的语法和元素结构可能显得复杂且抽象。本文将以“XSLT 元素参考手册”为核心，通过循序渐进的讲解、生动的比喻和实际案例，帮助读者掌握XSLT的核心元素及其应用逻辑，降低学习门槛。

一、XSLT 的基础概念与核心逻辑

1.1 什么是 XSLT？

XSLT 是一种用于转换XML文档的语言，它通过定义一系列规则（称为“样式表”）将原始XML内容转换为目标格式。可以将其想象为“翻译官”：原始XML是“源语言”，XSLT规则是“翻译指南”，最终输出则是“目标语言”的结果。

1.2 核心工作流程

XSLT 的工作流程分为三个步骤：

1. 匹配（Matching）：根据XPath表达式，确定XML文档中的哪些节点需要被处理。
2. 模板（Template）：为匹配的节点定义具体的转换规则，例如如何生成HTML标签或文本内容。
3. 应用（Applying）：将模板规则逐层应用到XML节点，最终生成目标格式的输出。

1.3 XSLT 的基本结构示例

<?xml version="1.0" encoding="UTF-8"?>  
<xsl:stylesheet version="1.0"  
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform">  
    <xsl:template match="/">  
        <!-- 转换规则在此处定义 -->  
    </xsl:template>  
</xsl:stylesheet>  

此示例展示了XSLT样式表的基本框架，其中<xsl:stylesheet>是根元素，而<xsl:template>用于定义具体的转换逻辑。

二、核心元素详解：构建XSLT的基石

2.1 <xsl:template>：模板的定义与匹配

作用：定义如何处理特定的XML节点。
语法：

<xsl:template match="XPath表达式">  
    <!-- 转换逻辑 -->  
</xsl:template>  

案例：假设XML中有一个<book>节点，我们希望将其转换为HTML表格：

<xsl:template match="book">  
    <tr>  
        <td><xsl:value-of select="title"/></td>  
        <td><xsl:value-of select="author"/></td>  
    </tr>  
</xsl:template>  

比喻：模板就像“食谱”，告诉XSLT如何“烹饪”每个匹配的XML节点。

2.2 <xsl:apply-templates>：递归处理与流程控制

作用：触发对子节点的递归处理，实现分层转换。
语法：

<xsl:apply-templates select="XPath表达式"/>  

案例：处理包含多个章节的书籍结构：

<!-- 父模板处理书籍整体 -->  
<xsl:template match="book">  
    <div class="book">  
        <h1><xsl:value-of select="title"/></h1>  
        <xsl:apply-templates select="chapter"/>  
    </div>  
</xsl:template>  

<!-- 子模板处理章节 -->  
<xsl:template match="chapter">  
    <section>  
        <h2><xsl:value-of select="@title"/></h2>  
        <xsl:apply-templates select="paragraph"/>  
    </section>  
</xsl:template>  

比喻：<xsl:apply-templates>如同“分派员”，将任务逐层分配给子节点的“下属模板”处理。

2.3 <xsl:value-of>：提取节点值

作用：直接输出XML节点的文本内容。
语法：

<xsl:value-of select="XPath表达式"/>  

案例：提取书籍的标题和作者：

<xsl:template match="book">  
    标题：  
    <xsl:value-of select="title"/>  
    <br/>  
    作者：  
    <xsl:value-of select="author"/>  
</xsl:template>  

注意：若XPath匹配多个节点，仅输出第一个节点的值。

2.4 <xsl:for-each>：遍历节点集合

作用：循环处理多个匹配的XML节点。
语法：

<xsl:for-each select="XPath表达式">  
    <!-- 循环体内容 -->  
</xsl:for-each>  

案例：遍历书籍列表生成HTML列表：

<xsl:template match="books">  
    <ul>  
        <xsl:for-each select="book">  
            <li>  
                <xsl:value-of select="title"/>  
            </li>  
        </xsl:for-each>  
    </ul>  
</xsl:template>  

比喻：<xsl:for-each>如同“生产线上的传送带”，将每个节点逐一“加工”并输出。

2.5 <xsl:if> 和 <xsl:choose>：条件判断

作用：根据条件选择性地执行转换逻辑。
语法：

<!-- 单条件判断 -->  
<xsl:if test="XPath表达式">  
    <!-- 条件成立时的输出 -->  
</xsl:if>  

<!-- 多条件分支 -->  
<xsl:choose>  
    <xsl:when test="条件1">  
        <!-- 条件1成立时的输出 -->  
    </xsl:when>  
    <xsl:when test="条件2">  
        <!-- 条件2成立时的输出 -->  
    </xsl:when>  
    <xsl:otherwise>  
        <!-- 默认输出 -->  
    </xsl:otherwise>  
</xsl:choose>  

案例：根据书籍类型显示不同图标：

<xsl:template match="book">  
    <div>  
        <xsl:choose>  
            <xsl:when test="@type = 'fiction'">  
                <img src="fiction.png"/>  
            </xsl:when>  
            <xsl:otherwise>  
                <img src="non-fiction.png"/>  
            </xsl:otherwise>  
        </xsl:choose>  
        <xsl:value-of select="title"/>  
    </div>  
</xsl:template>  

比喻：条件语句如同“交通信号灯”，根据规则决定“绿灯通行”或“红灯等待”。

2.6 <xsl:variable> 和 <xsl:param>：变量与参数

作用：存储临时值或接收外部参数，增强代码的灵活性。
语法：

<!-- 定义变量 -->  
<xsl:variable name="变量名" select="XPath表达式"/>  

<!-- 使用变量 -->  
<xsl:value-of select="$变量名"/>  

<!-- 接收外部参数 -->  
<xsl:param name="参数名" select="默认值"/>  

案例：计算书籍总价（假设每本书价格相同）：

<xsl:variable name="price-per-book" select="19.99"/>  
<xsl:template match="books">  
    总价：  
    <xsl:value-of select="count(book) * $price-per-book"/>  
</xsl:template>  

比喻：变量如同“便签纸”，临时记录关键数据以便后续使用。

三、进阶元素与高级技巧

3.1 <xsl:call-template> 和 <xsl:with-param>：模板调用与参数传递

作用：复用模板逻辑，实现代码的模块化。
语法：

<!-- 定义可调用的模板 -->  
<xsl:template name="my-template">  
    <xsl:param name="param1"/>  
    <!-- 使用参数 -->  
</xsl:template>  

<!-- 调用模板 -->  
<xsl:call-template name="my-template">  
    <xsl:with-param name="param1" select="value"/>  
</xsl:call-template>  

案例：复用书籍价格计算逻辑：

<xsl:template name="calculate-price">  
    <xsl:param name="quantity"/>  
    <xsl:value-of select="$quantity * 19.99"/>  
</xsl:template>  

<xsl:template match="order">  
    <xsl:call-template name="calculate-price">  
        <xsl:with-param name="quantity" select="count(items/item)"/>  
    </xsl:call-template>  
</xsl:template>  

3.2 <xsl:copy> 和 <xsl:copy-of>：节点复制

作用：直接复制节点或其内容，避免重复编写模板。
语法：

<!-- 复制节点及子节点 -->  
<xsl:copy-of select="XPath表达式"/>  

<!-- 复制节点但保留修改空间 -->  
<xsl:copy>  
    <xsl:apply-templates select="@* | node()"/>  
    <!-- 追加或修改内容 -->  
</xsl:copy>  

案例：复制书籍节点并添加分类标签：

<xsl:template match="book">  
    <xsl:copy>  
        <xsl:apply-templates select="@* | node()"/>  
        <category>  
            <xsl:value-of select="@type"/>  
        </category>  
    </xsl:copy>  
</xsl:template>  

3.3 错误处理与调试技巧

• 常见错误：XPath表达式错误、模板匹配冲突、变量作用域问题。
• 调试方法：
  1. 使用<xsl:message>输出调试信息；
  2. 逐步简化样式表，定位问题节点；
  3. 利用在线工具（如XML Grid）实时查看转换结果。

四、实战案例：构建完整的书籍目录转换

4.1 源XML数据

<books>  
    <book type="fiction">  
        <title>百年孤独</title>  
        <author>加西亚·马尔克斯</author>  
    </book>  
    <book type="non-fiction">  
        <title>人类简史</title>  
        <author>尤瓦尔·赫拉利</author>  
    </book>  
</books>  

4.2 XSLT样式表

<xsl:stylesheet version="1.0"  
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform">  

    <!-- 主模板：处理书籍列表 -->  
    <xsl:template match="/books">  
        <html>  
            <body>  
                <h1>书籍目录</h1>  
                <table border="1">  
                    <tr>  
                        <th>标题</th>  
                        <th>作者</th>  
                        <th>类型</th>  
                    </tr>  
                    <xsl:apply-templates select="book"/>  
                </table>  
            </body>  
        </html>  
    </xsl:template>  

    <!-- 子模板：处理单个书籍 -->  
    <xsl:template match="book">  
        <tr>  
            <td><xsl:value-of select="title"/></td>  
            <td><xsl:value-of select="author"/></td>  
            <td>  
                <xsl:choose>  
                    <xsl:when test="@type = 'fiction'">  
                        小说  
                    </xsl:when>  
                    <xsl:otherwise>  
                        非虚构  
                    </xsl:otherwise>  
                </xsl:choose>  
            </td>  
        </tr>  
    </xsl:template>  
</xsl:stylesheet>  

4.3 输出结果

<html>  
<body>  
    <h1>书籍目录</h1>  
    <table border="1">  
        <tr>  
            <th>标题</th>  
            <th>作者</th>  
            <th>类型</th>  
        </tr>  
        <tr>  
            <td>百年孤独</td>  
            <td>加西亚·马尔克斯</td>  
            <td>小说</td>  
        </tr>  
        <tr>  
            <td>人类简史</td>  
            <td>尤瓦尔·赫拉利</td>  
            <td>非虚构</td>  
        </tr>  
    </table>  
</body>  
</html>  

五、结论与展望

通过本文的讲解，读者应能掌握XSLT的核心元素及其应用场景。XSLT 元素参考手册不仅是技术文档的“字典”，更是数据转换的“瑞士军刀”，能够帮助开发者高效地将XML数据转化为所需的格式。随着技术的发展，XSLT在静态站点生成、数据迁移等领域仍具有不可替代的价值。建议读者通过实际项目练习，逐步深入理解XSLT的逻辑与潜力，将其融入日常开发流程中。

未来，随着XML在物联网（IoT）和跨平台数据交换中的普及，掌握XSLT将为开发者打开更多技术可能性的大门。希望本文能成为读者探索XSLT世界的起点，并在后续实践中不断精进技能。