XML文件头部声明使用iso-8859-1编码也就是Latin-1字符集时，经常会出现中文乱码的情况，这主要是因为Latin-1字符集的覆盖范围仅包含西欧常用字符，本身不支持中文、日文等东亚字符，当文件中存在中文内容时，编码和解码的过程就会出现不匹配。
乱码产生的根本原因
XML文件的编码涉及两个层面，一个是文件头部<?xml version="1.0" encoding="iso-8859-1"?>中的编码声明，另一个是文件本身的真实存储编码。
当声明编码为iso-8859-1时，XML解析器会默认按照Latin-1的规则去解码文件内容。如果文件真实编码是UTF-8且包含中文，中文的UTF-8字节流在Latin-1解码规则下会被映射为无效的字符，最终表现为乱码。还有一种情况是文件真实存储编码就是iso-8859-1，此时中文根本无法被正确存储，必然会出现乱码。
解决方案一：修改XML头部编码声明
如果XML文件的真实存储编码是支持中文的编码（比如UTF-8、GBK），最直接的方式是修改头部的encoding属性，将其改为和文件真实编码一致的值。
例如原来的XML文件内容如下：
<?xml version="1.0" encoding="iso-8859-1"?>
<user>
<name>张三</name>
<age>25</age>
</user>
如果文件真实编码是UTF-8，只需要把encoding改为UTF-8即可：
<?xml version="1.0" encoding="UTF-8"?>
<user>
<name>张三</name>
<age>25</age>
</user>
解决方案二：转换文件真实编码为iso-8859-1兼容格式
如果必须保留头部iso-8859-1的编码声明，就需要保证文件内容的所有字符都在Latin-1的覆盖范围内。但中文不在Latin-1范围内，因此需要对中文进行转义处理，比如使用XML字符实体或者CDATA段配合转义。
使用XML字符实体的方式，将中文转换为Unicode编码的十进制形式，示例如下：
<?xml version="1.0" encoding="iso-8859-1"?>
<user>
<name>张三</name>
<age>25</age>
</user>
这里张是“张”的Unicode十进制编码，三是“三”的Unicode十进制编码，Latin-1编码可以正常解析这些实体字符，不会出现乱码。
解决方案三：解析时手动指定编码
如果是通过代码解析XML文件，也可以在解析时忽略头部的编码声明，手动指定正确的编码来读取文件。以Java的DOM解析为例：
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import org.w3c.dom.Document;
import java.io.BufferedReader;
import java.io.FileInputStream;
import java.io.InputStreamReader;
public class XmlParseDemo {
public static void main(String[] args) throws Exception {
// 手动用UTF-8编码读取文件内容，忽略头部的iso-8859-1声明
BufferedReader reader = new BufferedReader(
new InputStreamReader(new FileInputStream("test.xml"), "UTF-8")
);
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
// 解析读取到的内容
Document document = builder.parse(new org.xml.sax.InputSource(reader));
System.out.println(document.getElementsByTagName("name").item(0).getTextContent());
}
}
不同方案的选择建议
如果是新生成的XML文件，优先选择修改头部编码声明为UTF-8，这是最通用也最不容易出问题的方案。如果是需要兼容旧系统的XML文件，必须保留iso-8859-1声明，就选择字符实体转义的方式。如果是解析第三方提供的固定格式的XML文件，无法修改文件内容，就选择解析时手动指定编码的方案。
需要注意的是，修改编码后最好用对应的解析器测试验证，避免出现其他隐藏的编码问题。另外如果XML文件中包含特殊字符，也需要按照XML的规范进行转义处理，避免解析报错。
XMLiso-8859-1编码Latin-1字符集中文乱码修改时间：2026-06-28 22:06:35