XSLT通过模板规则将XML文档转换成其他格式，而当一个节点能同时匹配多个模板的match属性时，处理器必须决定使用哪一个。这个决策依赖两套机制：模式匹配优先级（priority）与样式表内的声明顺序。优先级是一个浮点数，由XSLT规范根据match表达式的结构自动推算，开发者也可使用priority属性手动指定。
一、默认优先级的计算规则
如果没有给模板显式写上priority属性，XSLT处理器会按照W3C规范中的默认优先级表来给match模式打分。最基础的规则是：匹配条件越具体、涉及轴或谓词越多，默认优先级数值越高。例如仅匹配元素名的模板优先级为0，而带属性的匹配会高于它。
具体来说，仅由元素或属性名组成的模式（如match="book"）优先级为0；使用子轴、后代轴等带显式轴名的模式（如match="book/title"）优先级为0.25；带有谓词过滤的模式（如match="book[@id]"）优先级为0.25；而同时包含轴与谓词的模式（如match="book[@id]/title"）优先级为0.5。这种分层设计让更精确的描述自然胜出。
1.1 常见模式的默认优先级示例
下面用一段样式表片段展示不同match写法对应的隐含优先级差异。注意我们并未手写priority，完全依赖规范推算。
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<!-- 优先级 0 -->
<xsl:template match="book">
<p>普通书</p>
</xsl:template>
<!-- 优先级 0.25，因为用了属性谓词 -->
<xsl:template match="book[@id]">
<p>带id的书</p>
</xsl:template>
<!-- 优先级 0.5，轴加谓词 -->
<xsl:template match="book[@id]/title">
<p>带id书的标题</p>
</xsl:template>
</xsl:stylesheet>
当输入XML中某个book元素拥有id属性时，它既匹配第一个模板也匹配第二个，但第二个优先级0.25大于0，于是输出“带id的书”。如果里面还有title子元素，则第三个模板以0.5胜出。
1.2 为什么需要理解默认优先级
很多转换错误源于开发者以为“写在后面的模板会覆盖前面”，却忽略了默认优先级更高的情况。优先级是首要过滤条件，只有优先级相同的模板才比较出现顺序。弄清这一点，可以减少大量不必要的priority硬编码。
另外，XPath中的通配符如match="*"优先级也是0，而match="/"匹配根节点优先级为-0.5，它总是最低，因此根模板通常作为兜底。
二、使用priority属性手动覆盖
当默认推算不符合预期，或多个模式默认优先级相等却想明确指定胜者，可以用priority属性赋值。该值可以是任意实数，甚至负数。处理器先按priority数值从大到小排序，数值相同再按文档顺序取最后者。
例如两个模板默认都是0，但希望后者优先，可显式写priority="1"。手动指定在合并第三方样式表或写覆盖规则时非常有用。
2.1 手动优先级的代码示例
以下例子让特定分类的书忽略普通规则：
<xsl:template match="book" priority="0.5"> <p>常规处理</p> </xsl:template> <xsl:template match="book[category='free']" priority="1"> <p>免费书特殊处理</p> </xsl:template>
这里第二个模板手动设了更高priority，即使默认推算可能也是0.25，依然稳胜。若去掉priority，则靠默认0.25大于0自然胜出，但手动写更可读且防止未来规则干扰。
2.2 优先级冲突与导入
在xsl:import引入的样式表中，被导入文件的规则优先级整体降低约-0.5基础分，因此主样式表容易覆盖它。而xsl:include则是平级合并，按包含后的文档顺序处理。理解这点对大型项目复用样式至关重要。
如果多个模板priority完全一样且同文件同顺序位置（理论上不会），处理器报错或任选，因此避免故意写相等priority造成歧义。
三、匹配冲突的完整决策流程
综合来看，XSLT对某个节点选择模板遵循：先收集所有match为该节点返回真的模板；提取各自的priority（显式或默认）；选最大priority；若并列，选样式表中最后声明的；若来自import，则被导入者靠后考虑。
这一流程保证了确定性和可预测性。实践中建议：尽量依赖默认优先级表达自然具体程度，仅在交叉覆盖时用priority微调，并配合注释说明意图。
3.1 决策流程图式说明
虽然不能画图，但可用文字步骤描述：节点进入 -> 计算候选集 -> 算优先级 -> 排序 -> 取首 -> 执行。任何一步都可在调试时通过xsl:message输出匹配信息辅助。
| match写法 | 默认优先级 | 说明 |
|---|---|---|
| match="/" | -0.5 | 根节点 |
| match="book" | 0 | 元素名 |
| match="book[@id]" | 0.25 | 带谓词 |
| match="book/title" | 0.25 | 子轴 |
| match="book[@id]/title" | 0.5 | 轴加谓词 |
上表覆盖了绝大多数日常模式。遇到node()或text()等，默认优先级也为0，但text()匹配文本节点，与元素不匹配故不冲突。
3.2 编写健壮样式表的小结
把具体规则写在前且自然精确，利用默认优先级；把兜底规则如match="*"放最后且不设高priority；慎用import以免优先级混乱。这样可让XSLT转换稳定易维护。
当发现节点没走期望模板，第一步打印其匹配的所有模板与priority，而非盲目移动代码。掌握match优先级计算，才算真正入门XSLT控制流。
XSLTmatch_prioritytemplate_rule修改时间：2026-08-10 07:36:39