XML格式错误通常由根元素不唯一、标签未闭合、特殊字符未转义、属性值无引号、编码不一致等问题导致。首先确保有且仅有一个根元素包裹所有内容，如将多个<person>用<people>统一包裹；其次检查每个开始标签是否有对应结束标签或使用自闭合语法，避免混用；接着将&、<、>等特殊字符替换为实体引用，或用<![CDATA[ ]]>包裹含特殊字符的文本；然后确认所有属性值用双引号或单引号包围，推荐统一使用双引号；再利用在线校验工具、VS Code插件或命令行工具快速定位错误位置；最后确保XML声明中的encoding与文件实际编码一致，建议均采用UTF-8。按此步骤逐一排查，可高效修复绝大多数XML语法问题。
XML文件格式不正确时，程序通常无法解析，会报“格式错误”“未闭合标签”“非法字符”等异常。别担心，大多数问题都源于几个常见语法错误。只要按步骤排查，基本都能快速修复。以下是实用的XML语法错误修复方法，帮你一步步还原正确的XML结构。
1. 检查根元素是否存在且唯一
每个合法的XML文档必须有且仅有一个根元素，所有其他元素都要嵌套在它里面。
错误示例：<person><name>张三</name></person> <person><name>李四</name></person>
这段XML有两个根元素，会报错。
修复方法：用一个统一的根包裹所有内容：
<people> <person><name>张三</name></person> <person><name>李四</name></person> </people>
2. 确保所有标签正确闭合
XML要求每个开始标签都有对应的结束标签，或使用自闭合写法。
常见错误：- <name>王五 （缺少 </name>）
- <age />10</age> （混用自闭合和闭合标签）
- <name>王五</name>
- <age>10</age> 或 <age />（仅当无内容时）
3. 转义特殊字符
XML中以下字符不能直接使用，必须用实体引用代替：
- & → < &
- < → <
- > → < >
- " → < "
- ' → < '
如果文本中包含大量特殊字符，可以用 <![CDATA[ ... ]]> 包裹：
<description><![CDATA[价格 < 100 且数量 > 5]]></description>
4. 检查属性值是否用引号包围
所有属性值必须用双引号或单引号括起来。
错误写法：
<book id=123 title=XML指南>正确写法：
<book id="123" title="XML指南"></book>
推荐统一使用双引号，避免混淆。
5. 使用XML验证工具辅助排查
手动检查容易遗漏，建议用工具快速定位问题。
推荐方法：- 用记事本打开后复制内容到在线校验工具，如 XML Validation (freeformatter.com)
- 在VS Code中安装XML插件，实时高亮语法错误
- 用命令行执行：java -jar xmllint.jar --noout yourfile.xml
工具通常会提示错误位置，比如第几行第几个字符，方便精准修复。
6. 注意编码一致性
XML声明中的编码要与文件实际保存编码一致。
例如：<?xml version="1.0" encoding="UTF-8"?>
如果文件是UTF-8保存的，encoding就必须写UTF-8。否则可能出现乱码或解析失败。建议统一使用UTF-8编码保存文件。
基本上就这些。遇到XML格式错误，先看报错信息，再按结构、标签、字符、属性、编码一步步检查，99%的问题都能解决。保持良好的书写习惯，比如写完标签立即补闭合，能大幅减少出错概率。
