如何用XSLT复制XML主体并替换指定子节点（XSLT3.0场景）

需要替换XML中wantedNode2下的过时SubNode3节点为指定的静态新节点，之前使用except语法尝试过滤旧节点时因路径层级错误导致旧节点和新节点同时输出，无法完成替换。

源XML结构 #

<headerNode1>
  <headerNode2>
    <wantedNode1>
      <stuff/>
    </wantedNode1>
    <wantedNode2>
      <wantedSubNode1>
        <stuff/>
      </wantedSubNode1>
      <wantedSubNode2>
        <stuffA/>
      </wantedSubNode2>
      <wantedSubNode2>
        <stuffB/>
      </wantedSubNode2>
      <SubNode3>
        <stuffA/>
      </SubNode3>
      <SubNode3>
        <stuffB/>
      </SubNode3>
    </wantedNode2>
  </headerNode2>
</headerNode1>

目标输出结构 #

<root>
  <headerNode2>
    <wantedNode1>
      <stuff/>
    </wantedNode1>
    <wantedNode2>
      <wantedSubNode1>
        <stuff/>
      </wantedSubNode1>
      <wantedSubNode2>
        <stuffA/>
      </wantedSubNode2>
      <wantedSubNode2>
        <stuffB/>
      </wantedSubNode2>
      <SubNode3>
        <NewStuffA/>
      </SubNode3>
      <SubNode3>
        <NewStuffB/>
      </SubNode3>
    </wantedNode2>
  </headerNode2>
</root>

问题原因 #

之前的代码中，xsl:copy-of select="* except (wantedNode2/replacingSubNode3, unwantedNode4)"存在路径层级错误：

• 当前上下文是headerNode2，*指代的是headerNode2的直接子节点（wantedNode1和wantedNode2）
• wantedNode2/replacingSubNode3是wantedNode2的子节点，和*的层级不同，因此except无法过滤掉wantedNode2内部的SubNode3，最终导致旧节点被完整保留，同时新节点被追加输出。

解决方案 #

通过分层匹配模板的方式，针对wantedNode2单独处理，过滤其内部的旧SubNode3并插入新节点：

<xsl:stylesheet version="3.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <!-- 默认模式：未匹配的节点浅跳过，只处理自定义模板覆盖的节点 -->
    <xsl:mode on-no-match="shallow-skip"/>

    <!-- 处理根节点，输出指定的root容器 -->
    <xsl:template match="/">
        <root>
            <xsl:apply-templates select="headerNode1/headerNode2"/>
        </root>
    </xsl:template>

    <!-- 复制headerNode2节点及属性，处理其子节点 -->
    <xsl:template match="headerNode2">
        <xsl:copy>
            <xsl:apply-templates select="@* | *"/>
        </xsl:copy>
    </xsl:template>

    <!-- 完整保留wantedNode1节点（包括所有子节点） -->
    <xsl:template match="wantedNode1">
        <xsl:copy-of select="."/>
    </xsl:template>

    <!-- 处理wantedNode2：复制自身，过滤旧SubNode3，插入新节点 -->
    <xsl:template match="wantedNode2">
        <xsl:copy>
            <!-- 复制wantedNode2下除SubNode3外的所有子节点 -->
            <xsl:copy-of select="* except SubNode3"/>
            <!-- 插入静态新SubNode3节点 -->
            <SubNode3>
                <NewStuffA/>
            </SubNode3>
            <SubNode3>
                <NewStuffB/>
            </SubNode3>
        </xsl:copy>
    </xsl:template>
</xsl:stylesheet>

代码说明 #

1. 模式设置：xsl:mode on-no-match="shallow-skip"确保未被模板匹配的节点不会被输出，减少不必要的代码编写。
2. 分层处理：
   • 根节点模板负责输出外层的root容器，并定位到需要处理的headerNode2。
   • headerNode2模板复制自身并触发子节点的处理逻辑。
   • wantedNode1模板直接完整复制该节点，无需修改。
   • wantedNode2模板是核心：复制自身后，用* except SubNode3过滤掉内部的旧节点，再插入指定的静态新节点。

这样既保留了所有需要的节点结构，又精准替换了过时的SubNode3，避免了逐个指定保留节点的繁琐操作。

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