企业官网建设流程全解析

1. 从一次很头疼的排序说起

如果你用XSLT做过数据转换，八成会撞上同一个问题：输出的结果顺序不对。你明明在XML里看到的是干净整齐的记录，渲染出来却像是随手扔进去的。我最早用XSLT处理一批客户订单时就是这样，明明源文件里订单按日期排列得好好的，一经过转换全乱了。后来才明白，XSLT的模板处理顺序和XML文档顺序是两回事，而且不同处理器的默认行为也存在差异。要把数据按照你真正想要的方式排好，稳定可靠的做法就是显式使用<xsl:sort>元素。

这篇就专门把 XSLT 的<xsl:sort>元素掰开揉碎讲清楚。你会看到它支持哪些属性、每个属性的行为边界在哪里、多条件嵌套排序怎么写才有效、以及我在实际项目中踩过的几个坑。适合正在做XML到HTML、XML到文本、或者XML之间的重构映射、并且对输出顺序有要求的开发者。掌握了这个元素，你就不会再把顺序问题交给“运气”了。

2. 排序为什么不能靠处理器“自觉”

2.1 先搞清楚XSLT的处理模型

在展开<xsl:sort>之前，有必要先把 XSLT 的底层处理模型说清楚。XSLT样式表的核心机制是模板规则加模式匹配：处理器遍历源XML树，遇到节点就去匹配模板，匹配上了就执行模板里的指令。这个过程中，节点的访问顺序默认跟随文档顺序（document order），也就是节点在源XML中出现的先后顺序。但一旦你在<xsl:apply-templates>或<xsl:for-each>里加了<xsl:sort>，处理器的行为就变了：它会先构造一个待处理节点的列表，根据你声明的排序键把列表重新排列，然后再依次处理。

这一点很容易被忽略：<xsl:sort>不是“边输出边排序”，而是在真正开始模板处理之前，对候选节点集整体做一个预排序。所以排序键的计算也是基于节点在排序前的原始状态，而不是基于输出后的某些临时状态。这个心智模型如果你能建立起来，后面很多看似诡异的现象就都能解释了。

2.2 为什么源文件顺序会“丢”

我最初犯的错，是以为XSLT会保留源XML的顺序。这个假设在简单场景下成立，一旦你开始用<xsl:apply-templates select="item">这类写法，默认行为就是按照文档顺序逐个输出，除非你显式指定select时已经做了某种顺序控制。实际更常见的是，多个模板规则同时匹配一类节点时，匹配优先级（template priority）会决定谁先被调用，而优先级本身和文档顺序无关。再叠加<xsl:sort>就更容易出乱子了。

还有一个非常隐蔽的情况：XSLT处理器的输出顺序，可能与你在样式表里编写模板的先后顺序无关。是的，你没有看错。模板是声明式的，不是过程式的。所以如果你指望“把想先输出的模板写在前面，自然就排在前面”，这个思路从一开始就是错的。正确做法只有两种：要么用xsl:apply-templates的select精确控制节点范围，要么在循环或模板调用时显式排序。

2.3 显式排序是唯一靠谱的选择

既然处理器的默认行为在不同上下文里表现不同，那么唯一能让输出顺序稳定可控的方式，就是显式声明排序规则。<xsl:sort>就是为此设计的。它适用场景包括：

• 需要按日期、金额或名称等字段对输出结果排列；
• 需要多关键字分级排序，比如先按地区、再按金额、最后按时间；
• 需要自定义排序逻辑，比如按数值而不是字符串排序；
• 需要分组前先保证组内有序，或使用xsl:for-each-group时控制组的首次出现顺序。

综上所述，<xsl:sort>的价值不在于“把数据排一下”，而在于让数据在 XSLT 的声明式处理模型里，获得一个可预测、可维护的顺序。

3. 核心属性逐个拆解，找到各自的边界

3.1 select：排序键到底怎么写

select是<xsl:sort>里最核心的属性，它指定用于排序的表达式。最基础的写法就是节点名或属性路径，例如<xsl:sort select="price"/>表示按照当前节点的price子元素的值排序，而<xsl:sort select="@name"/>表示按当前节点的name属性排序。

但select的表达式远不止路径这么简单。你可以写任何返回字符串、数字或布尔值的XPath表达式，比如：

• <xsl:sort select="price * quantity"/>：按照订单金额排序；
• <xsl:sort select="substring(@code, 3, 2)"/>：按照代码中间两位排序；
• <xsl:sort select="translate(@name, 'abc', 'xyz')"/>：对名称先做字符替换再排序。

这里有个关键点：select返回的结果类型会影响排序方式。如果表达式结果是数字，很多处理器会按数值大小排；如果是字符串，就按字符串比较规则排。为了更精确地控制比较方式，你就需要后面的><orders> <order id="A100"> <customer>张三</customer> <amount>3280</amount> <date>2024-03-15</date> </order> <order id="A102"> <customer>李四</customer> <amount>1500</amount> <date>2024-04-02</date> </order> <order id="A101"> <customer>王五</customer> <amount>8200</amount> <date>2024-03-28</date> </order> </orders>

最基础的按金额降序排列输出HTML表格，可以这样写：

<xsl:template match="orders"> <table> <tr><th>客户</th><th>金额</th><th>日期</th></tr> <xsl:apply-templates select="order"> <xsl:sort select="amount"><xsl:template match="orders"> <xsl:apply-templates select="order"> <xsl:sort select="region"/> <xsl:sort select="amount"><xsl:for-each select="order" group-by="region"> <xsl:sort select="region"/> <h2><xsl:value-of select="current-grouping-key()"/></h2> <xsl:apply-templates select="current-group()"> <xsl:sort select="amount"><xsl:sort select="amount * (1 - discount)"><xsl:variable name="sortedOrders"> <xsl:for-each select="order"> <order id="{@id}"> <sortKey><xsl:value-of select="amount * (1 - discount)"/></sortKey> <xsl:copy-of select="*"/> </order> </xsl:for-each> </xsl:variable>

然后对$sortedOrders/order按sortKey排序。这种“先构造临时树再排序”的模式在某些复杂转换中很好用，但要注意它会产生额外内存占用和数据复制，数据量特别大时性能会下降。

6. 性能与会话思考：排序在大型数据下需要注意的大事

6.1 排序的内存开销从哪里来

很多人以为排序是“流式”的，数据一个接一个出来。实际上，只要出现<xsl:sort>，处理器就必须把整套候选节点存在内存里，排序完成后再逐个输出。因为排序需要“看完全部数据才能确定第一个输出谁”。这是算法本质决定的，<xsl:sort>天然不是一个流式操作。

这意味着：如果你在一个巨大的XML文档（比如几万条记录）上做全局排序，内存占用会明显上升。遇到这种情况可以考虑几个优化方向：

• 尽量缩小select范围，不要对整个文档做select="//*"然后排序；
• 如果只是展示前几条，优先在查询阶段或预处理器里做好，而不是全量排序后再截断；
• 使用支持流式处理的XSLT 3.0处理器，并在合适的场景下启用流式模板，但这需要额外设计，不是无脑替换。

6.2 排序键重复时的可预测性

前面提过stable="yes"是默认值。它的作用是：当排序键完全相同，输出顺序保留处理前的相对顺序。处理前的顺序是什么？对于xsl:apply-templates select="order"，处理前顺序就是节点集合构造时的顺序，通常是文档顺序。

这个特性在分页或逆序分页场景里很有用。比如你要实现“上一页/下一页”的分页输出，且希望首页从最早记录开始。如果你对日期升序排序，同时保持稳定，那么同日的多笔订单会按照源文档顺序输出，用户翻页时就能感知到稳定的次序。你不需要额外加一个序列号字段就能获得稳定的分页体验。

6.3 排序键为空或缺失时的行为

排序键为空（比如某个节点没有<amount>子元素），处理器如何处理？XSLT规范里，空序列和空字符串会被当作排序键参与比较，排序的结果根据比较规则确定，通常空值会被排到最前面（升序时）或最后面（降序时），具体行为因处理器而异。

这在统计报表里很要命：某几条记录缺失月份字段，结果全被排到最前面，报表看起来像是数据错乱。解决思路是给缺失值一个默认的极值：

<xsl:sort select="date"><xsl:sort select="if (date) then date else '9999-12-31'"><xsl:for-each select="order"> <xsl:sort select="amount"><xsl:template name="gen-sort-key"> <xsl:param name="node"/> <xsl:choose> <xsl:when test="$node/priority"> <xsl:value-of select="concat($node/priority, '-', $node/id)"/> </xsl:when> <xsl:otherwise> <xsl:value-of select="concat('0-', $node/id)"/> </xsl:otherwise> </xsl:choose> </xsl:template>

然后<xsl:sort select="concat(..., ...)"/>——不对，模板无法直接在select里调用。更实际的方案是用变量提前算好：

<xsl:variable name="items" select="order"/> <xsl:for-each select="$items"> <xsl:sort select="my:sort-key(.)" xmlns:my="..."/> </xsl:for-each>

如果你用的处理器支持扩展函数，可以注册自定义排序键函数，否则用XPath表达式内联实现。关键在于：排序键逻辑集中一处，不要散落在各个模板里。

8.3 与命名模板和模式的配合

排序不是只能用于apply-templates。你可以在命名模板里对传入的节点集排序，可以在不同mode下使用不同的排序规则。举例来说，同一个订单列表，在“摘要模式”下按金额降序输出前5条，在“明细模式”下按日期升序输出全部。这时你可以定义两个模式，分别带上不同的<xsl:sort>规则：

<xsl:template match="order" mode="summary"> <xsl:apply-templates select="." mode="summary-row"> <xsl:sort select="amount"><xsl:sort select="translate(normalize-space(customer), 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz')"/>

如果你需要在排序的同时保留原始显示值，这样写完全没问题：排序键是转换后的内容，显示时仍然用原始字段。

9. 写在最后：我实际用过之后的体会

从最早手忙脚乱地处理顺序问题，到现在看到<xsl:sort>就像看到老朋友，中间确实走了不少弯路。回头来看，最核心的认知就是一句话：XSLT里没有“默认顺序是正确的”这回事，凡是顺序影响了结果的地方，都要显式用<xsl:sort>来声明。这句话说起来容易，做起来难，因为你会经常被“源顺序恰好是对的”这种假象麻痹。

我的实践习惯可以总结为三条：第一，凡是数值字段排序，>