要设置XSLT输出的缩进格式，需在xsl:stylesheet中添加xsl:output并设置indent="yes"，如<xsl:output method="xml" indent="yes"/>，处理器会自动美化XML结构；但缩进效果受处理器实现、输出方法和空白处理影响，可能因处理器差异或xsl:strip-space导致缩进失效；精细控制可手动使用xsl:text插入换行与空格，但维护困难，建议结合格式化工具后处理；生产环境中为提升性能，应关闭indent以减少开销。
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
设置对不对？有没有过度地剥离空白字符？
如何在XSLT中精细控制特定元素的缩进？
说实话，XSLT的
indent="yes"
是一个相对全局的、粗粒度的控制。它告诉处理器“请帮我把整个输出美化一下”，但你很难直接告诉它“只有
div
元素内部缩进四个空格，而
p
元素内部不缩进”。XSLT的设计哲学更多是关于数据转换和结构重组，而不是一个强大的代码格式化工具。
如果真的需要精细到元素级别的缩进控制，
indent="yes"
通常就力不从心了。这时，我们可能需要采取一些“土办法”或者说更手动的方式。
一种方法是手动插入空白字符。你可以使用
xsl:text
元素来精确地插入换行符（


）和空格。例如：
<xsl:template match="myElement"> <xsl:text>
 </xsl:text><!-- 插入一个换行和四个空格 --> <myElement> <xsl:apply-templates/> </myElement> <xsl:text>
</xsl:text><!-- 插入一个换行 --> </xsl:template>
这种方式虽然能实现精确控制，但它的缺点也很明显：极其繁琐且难以维护。一旦缩进规则变化，你需要修改大量的模板。而且，它很容易和
indent="yes"
的自动行为冲突，导致出现双重缩进或混乱。所以，这种方法通常只在极少数、对格式要求非常苛刻且局部化的场景下使用。
更实际的做法是，接受
indent="yes"
带来的大致效果，或者干脆放弃在XSLT中做精细的格式化。对于需要严格按照特定规范（比如代码风格指南）进行格式化的场景，我更倾向于在XSLT处理之后，使用专门的代码格式化工具（如Prettier、XML Lint等）来对输出结果进行后处理。这样职责分离，XSLT专注于数据转换，格式化工具专注于格式化，各自发挥所长，效率和效果都会更好。
XSLT缩进与性能优化有何关联？
关于XSLT的缩进功能，有一个不常被提及但很实际的考量点，那就是它对性能的影响。我不是说
indent="yes"
会直接让你的XSLT慢得像蜗牛，但在某些场景下，它确实会引入不必要的开销。
当XSLT处理器被要求
indent="yes"
时，它需要做额外的工作：它不仅仅是简单地复制和转换数据，它还需要分析输出XML的结构，判断在哪里插入换行符和空格，以保持元素的嵌套关系和可读性。这个分析和插入的过程，对于处理器来说，是需要消耗CPU时间和内存的。
对于小型XML文件或开发调试阶段，这种性能开销几乎可以忽略不计。我们希望输出结果是美观的，方便人眼阅读和检查，所以
indent="yes"
是强烈推荐的。
然而，如果你的XSLT正在处理非常庞大的XML文件（比如几百MB甚至GB级别），或者你的系统需要处理高并发的XSLT转换请求（例如作为API网关的一部分，转换请求和响应），那么
indent="yes"
带来的额外计算就可能成为一个瓶颈。在这些场景下，每一毫秒的延迟都可能很重要，多余的空白字符也会增加网络传输的负担。
我的建议是，在生产环境下，尤其是在进行机器对机器通信（M2M）或者处理大数据量的转换时，通常应该禁用
indent
功能（即设置
indent="no"
，或者干脆不设置，因为
no
往往是默认值）。这样可以确保XSLT处理器只专注于核心的数据转换逻辑，减少不必要的计算，从而提升整体性能和响应速度。而在开发、测试或需要人工审查输出时，再开启
indent="yes"
，这是一种兼顾实用性和性能的策略。
