为何我的XSL会将同级元素输出为空元素的子元素？附XML代码

嘿，这个问题我之前帮人排查过好几次，大概率是你的XSL模板里对空元素（比如你XML里的<pagebreak>）的处理逻辑出了问题，导致后续的同级元素被错误地嵌套进去了。我给你拆解下常见原因和解决办法：

最常见的问题：错误地在空元素模板中处理后续同级节点 #

比如你可能写了类似这样的<pagebreak>模板：

<xsl:template match="pagebreak">
  <page-break>
    <xsl:attribute name="orientation">
      <xsl:value-of select="@orientation"/>
    </xsl:attribute>
    <!-- 这里犯了关键错误：调用apply-templates处理后续同级节点 -->
    <xsl:apply-templates select="following-sibling::*"/>
  </page-break>
</xsl:template>

这段代码会把<pagebreak>之后的所有同级元素（也就是你的<h2>、<figure-gallery>这些）都塞进<page-break>标签里，变成它的子元素。

解决办法：

• 删掉select="following-sibling::*"这行，空元素本身没有子节点，不需要额外处理后续节点——这些节点会由上级模板（比如匹配<text>的模板）里的<xsl:apply-templates/>统一处理。
• 更简洁的写法可以用属性值模板，避免冗余代码：

<xsl:template match="pagebreak">
  <page-break orientation="{@orientation}"/>
</xsl:template>

另一种可能：上级模板的循环/条件逻辑出错 #

比如你在处理<text>元素的模板里，用了for-each或者if判断，不小心把后续元素包进了空元素的输出结构里：

<xsl:template match="text">
  <div class="text-content">
    <xsl:for-each select="*">
      <xsl:if test="self::pagebreak">
        <div class="pagebreak">
          <xsl:apply-templates select="."/>
          <!-- 错误：这里处理了当前节点之后的所有元素 -->
          <xsl:apply-templates select="following-sibling::*"/>
        </div>
      </xsl:if>
      <!-- 其他元素的处理逻辑 -->
    </xsl:for-each>
  </div>
</xsl:template>

这种情况下，<pagebreak>后面的元素会被重复处理，并且嵌套到<div class="pagebreak">里面。

解决办法：

• 让每个元素的处理相互独立，不要在某个元素的分支里处理其他元素。比如把<xsl:apply-templates/>直接放在<text>模板里，代替for-each：

<xsl:template match="text">
  <div class="text-content">
    <xsl:apply-templates/>
  </div>
</xsl:template>

这样每个子元素（包括<h6>、<p>、<pagebreak>）都会被各自的模板单独处理，不会出现嵌套错误。

最后排查：检查默认模板的影响 #

如果你的XSL没有覆盖所有元素的模板，XSL的默认模板会自动处理文本和元素节点，可能导致意外的嵌套。比如如果你的<pagebreak>模板没有明确终止，默认模板可能会“顺手”把后续节点拉进来。

解决办法：

• 给所有需要处理的元素都写明确的模板，避免依赖默认模板的行为。比如给<h6>、<p>、<h2>、<figure-gallery>等都单独写匹配模板，确保每个元素的输出结构都在你的控制范围内。

内容的提问来源于stack exchange，提问作者Ashley