XSLT如何输出XML声明？

XSLT作为XML转换的核心技术，在将源XML文档转换为目标格式时，经常需要生成符合规范的XML文档，而XML声明是标准XML文档的必要组成部分。XML声明通常位于文档第一行，格式为<?xml version="1.0" encoding="UTF-8"?>，包含版本号和字符编码信息，部分场景还会包含独立文档标识。

XSLT输出XML声明的核心配置

XSLT中控制输出内容的核心元素是<xsl:output>，通过配置该元素的属性，可以指定转换后输出的文档类型、编码、是否包含XML声明等信息。要输出XML声明，需要重点关注以下属性：

• method：指定输出文档的方法，设置为xml时才会输出XML声明，默认值为xml，若设置为html或text则不会输出XML声明。
• version：指定XML声明的版本号，默认值为1.0，可设置为1.1等其他XML版本。
• encoding：指定XML声明中的字符编码，默认值为UTF-8，可根据需求设置为GBK、ISO-8859-1等编码。
• omit-xml-declaration：控制是否省略XML声明，默认值为no，设置为yes时不会输出XML声明。

基础输出示例

以下是一个最简单的XSLT示例，配置后转换源XML时会输出标准的XML声明：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <!-- 配置输出为XML格式，包含XML声明 -->
    <xsl:output method="xml" version="1.0" encoding="UTF-8" omit-xml-declaration="no"/>
    
    <xsl:template match="/">
        <root>
            <xsl:apply-templates/>
        </root>
    </xsl:template>
</xsl:stylesheet>

当使用该XSLT转换任意源XML文档时，输出的结果开头会包含<?xml version="1.0" encoding="UTF-8"?>声明。

自定义XML声明参数

如果需要调整XML声明的版本或编码，只需修改<xsl:output>的对应属性即可，例如输出版本为1.1、编码为GBK的XML声明：

<?xml version="1.0" encoding="GBK"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output method="xml" version="1.1" encoding="GBK"/>
    
    <xsl:template match="/">
        <data>自定义编码的XML文档</data>
    </xsl:template>
</xsl:stylesheet>

转换后输出的XML声明会变为<?xml version="1.1" encoding="GBK"?>。

常见注意事项

在实际使用中，需要注意以下场景避免XML声明输出异常：

• 如果<xsl:output>的method属性设置为html或text，即使其他属性配置正确，也不会输出XML声明。
• 部分XSLT处理器在输出到字符串或特定环境时，可能会忽略<xsl:output>的配置，此时需要检查处理器的相关参数设置。
• 若需要输出独立文档标识，可添加standalone属性，例如<xsl:output standalone="yes"/>，输出的XML声明会包含standalone="yes"内容。

完整转换示例

以下是源XML、XSLT样式表和转换后结果的完整示例：

源XML文档：

<user>
    <name>张三</name>
    <age>25</age>
</user>

对应的XSLT样式表：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output method="xml" version="1.0" encoding="UTF-8"/>
    
    <xsl:template match="/user">
        <user_info>
            <username><xsl:value-of select="name"/></username>
            <userage><xsl:value-of select="age"/></userage>
        </user_info>
    </xsl:template>
</xsl:stylesheet>

转换后的输出结果：

<?xml version="1.0" encoding="UTF-8"?>
<user_info>
    <username>张三</username>
    <userage>25</userage>
</user_info>

XSLTXML声明xsl_outputXML转换XSLT配置修改时间：2026-07-18 07:15:23