XSLT作为XML转换的核心技术，在将XML文档转换为HTML、文本或其他格式文档时，字符编码的设置直接影响输出内容的可读性和正确性。如果编码配置错误，很容易出现中文乱码、特殊符号无法显示等问题，因此掌握XSLT字符编码输出的设置方法非常重要。
XSLT输出编码的核心配置指令
XSLT通过<xsl:output>指令来控制转换后的输出属性，其中encoding属性就是用来指定输出文档的字符编码。该指令通常放在XSLT样式表的根元素<xsl:stylesheet>或<xsl:transform>的子元素位置，属于全局配置项。
encoding属性的取值需要是符合IANA标准的字符集名称，常见的取值包括UTF-8、UTF-16、GBK、ISO-8859-1等。其中UTF-8是跨平台兼容性最好的编码，也是XSLT处理器的默认编码选项，大多数场景下优先选择UTF-8可以避免很多编码问题。
不同场景下的编码配置示例
1. 输出HTML文档设置UTF-8编码
当需要将XML转换为HTML页面时，配置UTF-8编码可以保证页面中的中文、特殊符号正常显示，具体XSLT样式表代码如下：
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- 设置输出编码为UTF-8，输出格式为HTML -->
<xsl:output method="html" encoding="UTF-8" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<title>XSLT输出编码示例</title>
</head>
<body>
<h1>用户信息</h1>
<p>用户名：<xsl:value-of select="user/name"/></p>
<p>简介：<xsl:value-of select="user/desc"/></p>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
2. 输出纯文本文档设置GBK编码
如果需要将XML转换为纯文本文件，且目标环境要求使用GBK编码，可以通过如下配置实现：
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- 设置输出编码为GBK，输出格式为文本 -->
<xsl:output method="text" encoding="GBK"/>
<xsl:template match="/">
<xsl:text>用户列表：</xsl:text>
<xsl:for-each select="users/user">
<xsl:value-of select="name"/>
<xsl:text>，年龄：</xsl:text>
<xsl:value-of select="age"/>
<xsl:text>
</xsl:text>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
3. 输出XML文档设置UTF-16编码
当转换后的结果需要以UTF-16编码的XML文档存储时，配置方式如下：
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- 设置输出编码为UTF-16，输出格式为xml -->
<xsl:output method="xml" encoding="UTF-16" indent="yes"/>
<xsl:template match="/">
<result>
<xsl:apply-templates select="data/*"/>
</result>
</xsl:template>
<xsl:template match="item">
<item>
<content><xsl:value-of select="."/></content>
</item>
</xsl:template>
</xsl:stylesheet>
常见编码问题及解决思路
- 输出内容乱码：首先检查
<xsl:output>的encoding属性是否和输出文档实际声明的编码一致，比如HTML中meta标签的charset需要和XSLT设置的encoding取值相同。 - 特殊字符无法转换：如果输出内容包含生僻字或特殊符号，优先选择UTF-8编码，因为UTF-8支持几乎所有Unicode字符，兼容性最好。
- 处理器不支持指定编码：部分老旧的XSLT处理器可能不支持某些编码类型，此时可以更换为处理器支持的通用编码，或者通过后续的文件转码工具调整编码。
注意事项
<xsl:output>指令的encoding属性只是告诉XSLT处理器输出时使用的字符集，最终输出文件的编码还会受保存文件时的编码设置影响。如果需要保证编码完全正确，建议在保存转换结果时，也按照设置的编码类型进行保存。另外，如果XSLT样式表本身包含非ASCII字符，样式表文件自身的编码也需要和<?xml?>声明中的encoding一致，避免出现样式表解析错误。
XSLT字符编码xml_outputencoding修改时间：2026-07-24 06:24:25