XSLT如何设置输出缩进格式？-XML/RSS教程-PHP中文网

XSLT如何设置输出缩进格式？

畫卷琴夢

发布： 2025-08-22 17:01:01

原创

296人浏览过

要设置XSLT输出的缩进格式，需在xsl:stylesheet中添加xsl:output并设置indent="yes"，如<xsl:output method="xml" indent="yes"/>，处理器会自动美化XML结构；但缩进效果受处理器实现、输出方法和空白处理影响，可能因处理器差异或xsl:strip-space导致缩进失效；精细控制可手动使用xsl:text插入换行与空格，但维护困难，建议结合格式化工具后处理；生产环境中为提升性能，应关闭indent以减少开销。

xslt如何设置输出缩进格式？

XSLT中要设置输出的缩进格式，核心操作其实非常直接，就是通过

xsl:output

登录后复制

元素来控制。你只需要在样式表的根元素下声明一个

xsl:output

登录后复制

，然后把它的

indent

登录后复制

属性设置为

yes

登录后复制

，XSLT处理器在生成结果文档时，就会尝试帮你把XML结构整理得更漂亮、更易读。

解决方案

要让XSLT输出带缩进的格式，你需要在你的XSLT样式表顶部，通常紧跟在

xsl:stylesheet

登录后复制

元素之后，加入

xsl:output

登录后复制

元素，并设置其

indent="yes"

登录后复制

。

一个基本的例子是这样的：

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

    <xsl:output method="xml" indent="yes" encoding="UTF-8"/>

    <!-- 你的模板规则 -->
    <xsl:template match="/">
        <root>
            <item id="1">
                <name>Apple</name>
                <price>1.00</price>
            </item>
            <item id="2">
                <name>Banana</name>
                <price>0.50</price>
            </item>
        </root>
    </xsl:template>

</xsl:stylesheet>

登录后复制

当这个样式表被应用到一个XML输入（即使是空的）时，输出结果会像这样：

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <item id="1">
    <name>Apple</name>
    <price>1.00</price>
  </item>
  <item id="2">
    <name>Banana</name>
    <price>0.50</price>
  </item>
</root>

登录后复制

你会发现，输出的XML声明

<?xml version="1.0" encoding="UTF-8"?>

登录后复制

和根元素

root

登录后复制

以及其子元素都得到了良好的缩进。如果不需要XML声明，你还可以添加

omit-xml-declaration="yes"

登录后复制

。

XSLT输出缩进为何时而无效或不尽如人意？

我个人在实际工作中遇到过不少次，明明设置了

indent="yes"

登录后复制

，结果输出的XML却依然挤作一团，或者缩进效果和预期有偏差。这背后其实有几个常见的原因，理解它们能帮助我们更好地排查问题。

一个主要因素是XSLT处理器的实现差异。不同的XSLT处理器（比如Saxon、Xalan、libxslt等）对

indent="yes"

登录后复制

的解释和实现方式可能不完全一致。有些处理器可能更“聪明”，能处理更复杂的场景；有些则相对保守，可能只做最基本的缩进。这就像不同的浏览器对CSS规范的实现细节略有不同一样，我们不能指望它们百分百一致。

再者，输出方法（

method

登录后复制

属性）的选择也会影响。如果你设置

method="html"

登录后复制

，处理器可能会根据HTML的规则来缩进，这和

method="xml"

登录后复制

或

method="text"

登录后复制

的逻辑会有所不同。特别是

text

登录后复制

方法，通常根本不会进行任何结构化的缩进，因为它只关注纯文本输出。

空白字符处理是另一个容易被忽视的关键。XSLT中，

xsl:strip-space

登录后复制

和

xsl:preserve-space

登录后复制

元素对于输入文档中的空白字符（空格、制表符、换行符）处理方式有很大影响。如果你在样式表中大量使用了

xsl:strip-space

登录后复制

，移除了输入XML中本来就存在的很多空白，那么处理器在生成输出时，可能就失去了很多“线索”来判断哪里应该缩进。特别是当元素内容是混合内容（既有文本又有子元素）时，处理器为了不改变原有的文本语义，可能会选择不进行激进的缩进。

有时候，输出中包含CDATA节或注释也可能导致缩进出现“断层”。处理器在处理这些特殊节点时，为了保持其原样，可能会暂时中断正常的缩进逻辑。

所以，如果你的缩进效果不理想，不妨从这几个方面入手检查一下：你用的是哪个XSLT处理器？

xsl:output

登录后复制

的

method

登录后复制

设置对不对？有没有过度地剥离空白字符？

比格设计

比格设计是135编辑器旗下一款一站式、多场景、智能化的在线图片编辑器

124

查看详情

如何在XSLT中精细控制特定元素的缩进？

说实话，XSLT的

indent="yes"

登录后复制

是一个相对全局的、粗粒度的控制。它告诉处理器“请帮我把整个输出美化一下”，但你很难直接告诉它“只有

div

登录后复制

元素内部缩进四个空格，而

登录后复制

元素内部不缩进”。XSLT的设计哲学更多是关于数据转换和结构重组，而不是一个强大的代码格式化工具。

如果真的需要精细到元素级别的缩进控制，

indent="yes"

登录后复制

通常就力不从心了。这时，我们可能需要采取一些“土办法”或者说更手动的方式。

一种方法是手动插入空白字符。你可以使用

xsl:text

登录后复制

元素来精确地插入换行符（

&#xA;

登录后复制

）和空格。例如：

<xsl:template match="myElement">
    <xsl:text>&#xA;    </xsl:text><!-- 插入一个换行和四个空格 -->
    <myElement>
        <xsl:apply-templates/>
    </myElement>
    <xsl:text>&#xA;</xsl:text><!-- 插入一个换行 -->
</xsl:template>

登录后复制

这种方式虽然能实现精确控制，但它的缺点也很明显：极其繁琐且难以维护。一旦缩进规则变化，你需要修改大量的模板。而且，它很容易和

indent="yes"

登录后复制

的自动行为冲突，导致出现双重缩进或混乱。所以，这种方法通常只在极少数、对格式要求非常苛刻且局部化的场景下使用。

更实际的做法是，接受

indent="yes"

登录后复制

带来的大致效果，或者干脆放弃在XSLT中做精细的格式化。对于需要严格按照特定规范（比如代码风格指南）进行格式化的场景，我更倾向于在XSLT处理之后，使用专门的代码格式化工具（如Prettier、XML Lint等）来对输出结果进行后处理。这样职责分离，XSLT专注于数据转换，格式化工具专注于格式化，各自发挥所长，效率和效果都会更好。