为何在BaseX XQuery中用新元素包裹结果后格式会变化？

问题背景 #

在BaseX编辑器编写XQuery脚本时，原本返回独立元素序列的输出保持了缩进格式，但用<row>元素包裹结果后，输出变成无缩进的紧凑形式，与预期不符。

原脚本 #

for $pc in /fhx/batch_equipment_phase_class
let $pc_name := $pc/@name
return
  for $fb in $pc/phase_class_algorithm/function_block[@name != 'FAIL_MONITOR']
  let $fb_name := $fb/@name
  return
    for $step in /fhx/function_block_definition[@name = $fb/@definition]/sfc_algorithm/step
    let $step_name := $step/@name
    return
      for $action in $step/action
      let $action_name := $action/@name
      return
        (<phase_class>{data($pc_name)}</phase_class>,
        <fb>{data($fb_name)}</fb>,
        <step>{data($step_name)}</step>,
        <action>{data($step_name)}</action>,
        $action/*)

原输出（带缩进） #

<phase_class>4_AC25_CIPSU</phase_class>
<fb>RUN_LOGIC</fb>
<step>CLEAR_INT_BYP</step>
<action>CLEAR_INT_BYP</action>
<description>Step Message.</description>
<action_type>ASSIGN</action_type>
<qualifier>P</qualifier>
<expression>'^/STEP_MSG.CV' := "Clearing Interlock Bypasses";</expression>
<delay_time>0</delay_time>

修改后脚本（添加包裹） #

for $pc in /fhx/batch_equipment_phase_class
let $pc_name := $pc/@name
return
  for $fb in $pc/phase_class_algorithm/function_block[@name != 'FAIL_MONITOR']
  let $fb_name := $fb/@name
  return
    for $step in /fhx/function_block_definition[@name = $fb/@definition]/sfc_algorithm/step
    let $step_name := $step/@name
    return
      for $action in $step/action
      let $action_name := $action/@name
      return
      <row>
        <phase_class>{data($pc_name)}</phase_class>
        <fb>{data($fb_name)}</fb>
        <step>{data($step_name)}</step>
        <action>{data($step_name)}</action>
        {$action/*}
      </row>

当前输出（无缩进） #

<row><phase_class>4_AC25_CIPSU</phase_class><fb>RUN_LOGIC</fb><step>CLEAR_INT_BYP</step><action>CLEAR_INT_BYP</action><description>Step Message.</description><action_type>ASSIGN</action_type><qualifier>P</qualifier><expression>'^/STEP_MSG.CV' := "Clearing Interlock Bypasses";</expression><delay_time>0</delay_time></row>

预期输出（带缩进） #

<row>
   <phase_class>4_AC25_CIPSU</phase_class>
   <fb>RUN_LOGIC</fb>
   <step>CLEAR_INT_BYP</step>
   <action>CLEAR_INT_BYP</action>
   <description>Step Message.</description>
   <action_type>ASSIGN</action_type>
   <qualifier>P</qualifier>
   <expression>'^/STEP_MSG.CV' := "Clearing Interlock Bypasses";</expression>
   <delay_time>0</delay_time>
</row>

格式变化原因 #

1. 原脚本返回序列：原代码返回多个独立的顶级元素组成的序列，BaseX的pretty-print机制会自动为每个顶级节点添加换行和缩进，保障可读性。
2. 修改后返回单个元素：用<row>包裹后，返回的是单个完整元素节点。BaseX默认不对单个元素内部自动添加缩进，目的是避免破坏元素内文本节点的空白语义（比如保留原始文本的空格、换行）。

修复方案 #

方案1：使用fn:serialize()手动配置格式化 #

在返回<row>元素时，通过serialize()函数明确指定输出格式，强制开启缩进：

for $pc in /fhx/batch_equipment_phase_class
let $pc_name := $pc/@name
return
  for $fb in $pc/phase_class_algorithm/function_block[@name != 'FAIL_MONITOR']
  let $fb_name := $fb/@name
  return
    for $step in /fhx/function_block_definition[@name = $fb/@definition]/sfc_algorithm/step
    let $step_name := $step/@name
    return
      for $action in $step/action
      let $action_name := $action/@name
      return
        serialize(
          <row>
            <phase_class>{data($pc_name)}</phase_class>
            <fb>{data($fb_name)}</fb>
            <step>{data($step_name)}</step>
            <action>{data($step_name)}</action>
            {$action/*}
          </row>,
          map {
            'method': 'xml',
            'indent': true(),
            'omit-xml-declaration': true()
          }
        )

方案2：修改BaseX全局输出设置 #

• 图形界面操作：打开BaseX编辑器，点击菜单Options > Output，勾选Indent选项。
• 命令行/脚本前置配置：在查询语句前执行以下命令，临时开启全局缩进：

  set output:indent true;
  

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