XSLT作为一种将XML文档转换为其他格式的语言，其核心机制之一就是通过模板匹配节点并应用转换规则。当同一个XML节点能够同时满足多个模板的匹配条件时，处理器必须决定启用哪一个，这就引入了模板优先级的概念。许多转换中的诡异现象，往往源于对优先级规则的模糊理解。本文将从底层规范出发，详细拆解优先级如何计算、如何显式干预以及实际开发中如何排查匹配冲突。
默认优先级的计算原理
在XSLT规范中，如果没有为模板显式设置priority属性，处理器会为每一个匹配模式赋予一个默认的优先级数值。这个数值并非随意指定，而是根据模式中包含的节点测试类型、谓词数量以及名称匹配的具体程度来推算。例如，仅使用通配符星号匹配所有元素的模板，其默认优先级通常是最低的负三分之一个点；而通过具体元素名称如匹配book元素的模板，默认优先级则为正数零点五。这种设计的初衷是让更具体的匹配自然胜过宽泛的匹配。
进一步看，属性匹配与子节点轴匹配也会影响默认值。当模板模式里包含属性测试，比如匹配带有特定属性的节点，其默认优先级会高于仅匹配元素名的模式。如果模式中带有谓词过滤条件，每多一层谓词，默认优先级会相应降低，因为谓词增加了匹配的限制但同时也让模式变得更复杂，规范将其权重调低以避免掩盖简单名称匹配。理解这些隐性规则，能够帮助我们在不写priority的情况下预测哪个模板会被触发。
实际编写时，开发者常犯的错误是认为排在样式表后面的模板一定会覆盖前面的。在默认优先级不同的情况下，这个假设成立；但若两个模板拥有相同的默认优先级，例如两个都使用具体元素名匹配但针对不同轴的模式，此时才轮到声明顺序起作用，后写的胜出。因此，阅读他人样式表时，不能仅凭视觉顺序判断，而需脑内计算默认优先级。
利用priority属性显式控制
当默认优先级无法满足业务需求，或者多个模板的默认优先级恰好相同且需要明确指定胜负时，XSLT提供了priority属性供开发者直接赋值。该属性接受实数值，可以是正数、负数或零，数值越大代表优先级越高。处理器在筛选模板时，首先比较这一显式数值，完全忽略默认规则。这意味着哪怕一个通配符模板被标上了priority="10"，它也会击败任何未设优先级的具体元素模板。
使用显式优先级时，需要注意数值的粒度。由于XSLT允许任意实数，团队开发中建议约定一套阶梯数值，比如基础模板用0，业务覆盖用1、2，特殊例外用3，避免随意填写导致后续维护困惑。另外，priority属性只能写在<xsl:template>元素上，若写在<xsl:apply-templates>上则无意义，后者控制的是待处理节点集而非模板选择。下面代码片段展示了如何为两个冲突模板分配优先级：
在下面的示例里，我们故意让一个宽泛匹配和一个精确匹配共存，并通过priority解决歧义。这种写法在重构旧样式表时十分常见，当发现某些特殊节点没有被正确格式化，而通用模板总是抢先执行，就可以用显式优先级把特殊逻辑顶上去。
<xsl:template match="*" priority="1"> <xsl:comment>捕获所有未专门处理的元素</xsl:comment> <xsl:apply-templates/> </xsl:template> <xsl:template match="title" priority="2"> <h1><xsl:value-of select="."/></h1> </xsl:template>
上述代码中，虽然match="*"默认优先级很低，但被提升到了1，而title模板优先级为2，因此遇到title元素时依然选用后者，保证了标题被正确处理。如果反过来将星号模板优先级设为3，那么所有元素包括title都会走入星号分支，这演示了显式值的绝对话语权。在大型样式表中，这种手段可用于搭建分层覆盖体系，让通用逻辑与特殊逻辑和平共存。
多模板冲突的调试与最佳实践
即便掌握了规则，复杂项目里模板数量膨胀后，匹配结果仍可能背离预期。此时应当借助处理器输出的诊断信息或编写独立测试XML来定位。多数XSLT引擎在告警模式下会提示某个节点同时匹配了多个模板并列出各自优先级，这是最直接的排查线索。也可以在疑似模板内临时插入特殊文本标记，观察输出中标记出现的位置，从而反推实际生效的是哪一个。
从架构层面看，降低优先级混乱的根本方法是遵循模块化设计。将通用兜底模板集中在文件末尾并赋予较低优先级，把具体业务模板按功能分块，尽量减少交叉匹配。使用<xsl:import>和<xsl:include>时，被导入样式表中的模板优先级会按导入顺序叠加调整，后导入的样式表优先级更高，这相当于在默认规则外增加了一层维度，需要特别记录。
最后，避免在同一个样式表里对相同匹配模式重复定义模板而不设优先级，因为不同处理器对于这种错误的恢复策略略有差异，有的报错有的静默选后一个，这会损害可移植性。推荐在持续集成中运行多款处理器交叉验证，确保优先级逻辑稳健。只有将规范认知、显式标注和工程规范结合，才能彻底驾驭XSLT模板优先级。