
本文详解 XSLT 在含点(.)、冒号(:)、分号(;)等字符时看似“失效”的根本原因——实为默认排序行为(codepoint 序)与预期 ASCII 字典序不一致所致,并提供兼容 XSLT 1.0/2.0 的可落地修复方案。
本文详解 xslt `
在使用 XSLT 将 XML 转换为 HTML 报表(如员工名单、对账单)时,开发者常遇到 <sort></sort> 表现“异常”:含 .、:、; 的字符串未按直观的 ASCII 字典序(即在线字符串排序工具所用逻辑)排列。例如以下 XML 片段:
<employee>
<name><![CDATA[test 1.8 - test]]></name>
<name><![CDATA[test 4 - test]]></name>
<name><![CDATA[Test 2 - test]]></name>
</employee>若采用如下 XSLT 片段(注意:原问题中 select="name" 存在路径错误,应为 . 或省略):
<xsl:for-each select="employee/name">
<xsl:sort select="." case-order="upper-first"/>
<!-- 输出逻辑 -->
</xsl:for-each>实际输出为:
test 1.8 - test Test 2 - test test 4 - test
而非期望的 ASCIIbatical(ASCII 字典)顺序:
Test 2 - test test 1.8 - test test 4 - test
关键澄清:这不是“特殊字符导致排序崩溃”,而是 XSLT 默认排序机制的精确体现。
XSLT 1.0 规范规定:<sort></sort> 默认使用 Unicode codepoint 值排序(即 U+003B 分号 <code>U+0026 和 <code>U+0054 大写 T),这与传统 ASCII 字典序(区分大小写、按字符编码逐位比较)高度一致,但不等同于“忽略大小写+本地化语义”的自然排序。问题中观察到的 ; 排在 & 前、T1 排在小写串前,正是 codepoint 序的真实结果(;=59, &=38, T=84 → 故 & ; T)。
✅ 正确修复路径
方案一:XSLT 2.0+(推荐,语义清晰)
使用标准化 collation 显式指定 ASCII 字典序(大小写敏感):
<xsl:for-each select="employee/name">
<xsl:sort select="."
collation="http://www.w3.org/2005/xpath-functions/collation/codepoint"/>
<xsl:value-of select="."/>
</xsl:for-each>✅ 优势:语义明确、跨处理器一致;
⚠️ 注意:需确认运行环境支持 XSLT 2.0(如 Saxon-HE、BaseX),JDK 内置 Xalan 仅支持 1.0。
方案二:XSLT 1.0 兼容方案(零依赖升级)
通过 translate() 函数统一大小写 + codepoint 排序(模拟 case-insensitive ASCII 序):
<xsl:for-each select="employee/name">
<!-- 先转小写再排序,确保 'Test' 和 'test' 同级比较 -->
<xsl:sort select="translate(., 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz')"/>
<xsl:value-of select="."/>
</xsl:for-each>若需严格保持首字母大写优先(如 Test test),则改用:
<xsl:sort select="." data-type="text" order="ascending" case-order="upper-first"/>
✅
case-order="upper-first"是 XSLT 1.0 标准属性,明确要求大写字母排在小写之前,符合多数业务场景的“标题式排序”预期。
⚠️ 常见误区排查
-
路径错误:
<sort select="name"></sort>在for-each select="employee/name"上下文中会尝试找name/name,应改为select="."(当前节点)或直接省略(默认按当前节点值排序)。 -
CDATA 干扰? 否。CDATA 仅影响解析阶段,XPath 处理的是已解析的文本节点值,
.可正确获取其内容。 - Java DOM4J 额外限制? DOM4J 本身不干预 XSLT 排序逻辑,但需确保使用的 TransformerFactory 加载的是支持目标 XSLT 版本的实现(如切换至 Saxon)。
总结
XSLT 排序“不工作”的本质,是混淆了 codepoint 序(规范默认)、本地化 collation(XSLT 2.0+)与 业务语义排序(如“首字母大写优先”)。解决核心在于:
- 明确排序目标(是否区分大小写?是否需 Unicode 归一化?);
- 选择匹配 XSLT 版本的正确属性(
case-order/collation); - 验证处理器能力(
System.out.println(TransformerFactory.newInstance().getClass().getName()))。
生产环境中,建议在 XSLT 文件头部显式声明版本并注释排序意图:
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> <!-- 排序策略:ASCII 字典序,大写字母优先(XSLT 1.0 兼容) -->
如此,即可让 .、;、: 等字符回归其应有的字节序位置,让报表生成稳定可控。

















