XML指南——XML编码

XML编码指的是XML文档使用的字符编码格式，它决定了文档中能够存储哪些字符，以及解析器如何正确读取文档内容。正确设置XML编码是保证文档正常解析的基础，编码设置错误很容易导致中文、特殊符号等内容出现乱码问题。

XML编码的声明方式

XML文档的编码需要在文档开头的XML声明中指定，语法格式如下：

<?xml version="1.0" encoding="编码格式"?>

其中encoding属性就是用来指定编码格式的，常见的编码格式包括UTF-8、GBK、ISO-8859-1等。如果不指定encoding属性，大部分XML解析器会默认使用UTF-8编码来解析文档。

常见编码格式的特点

• UTF-8：是一种可变长度的Unicode编码，兼容ASCII字符，支持全球几乎所有语言的字符，是XML文档最推荐的编码格式，跨平台兼容性最好。
• GBK：是针对中文的编码格式，兼容GB2312，仅支持中文、英文等部分字符，在仅涉及中文内容的场景中可以使用，但跨语言场景兼容性不如UTF-8。
• ISO-8859-1：是单字节编码，仅支持西欧语言的字符，不支持中文，一般不建议用于包含中文的XML文档。

编码设置的注意事项

设置XML编码时需要遵循以下规则，避免出现解析错误：

1. XML声明必须放在文档的第一行，前面不能有任何其他内容，包括空格、空行。
2. 指定的编码格式必须和实际保存文档时使用的编码一致，比如声明了encoding="UTF-8"，那么文档保存时也必须选择UTF-8编码，否则会出现乱码。
3. 如果文档中包含中文、日文等非ASCII字符，不建议使用ISO-8859-1编码，否则这些字符会被解析为乱码。

编码错误示例与解决

下面是一个典型的编码不匹配导致错误的示例：

<?xml version="1.0" encoding="UTF-8"?>
<user>
    <name>张三</name>
    <age>25</age>
</user>

如果这份文档实际保存时使用的是GBK编码，那么解析器按照UTF-8去解析张三这两个字符时，就会出现乱码或者解析报错。解决方法就是要么把文档保存编码改为UTF-8，要么把XML声明中的encoding改为GBK，保证两者一致即可。

不同场景下的编码选择建议

XML编码XML声明UTF-8GBK字符乱码 本作品最后修改时间：2026-05-22 23:42:38