XML“格式不良好”指文档违反Well-Formed规则，解析器无法读取。必须满足：有且仅有一个根元素；标签正确闭合与嵌套；属性值用引号包围；大小写敏感；特殊字符需转义。常见错误包括多根节点、标签未闭合、属性无引号、未转义特殊字符。修复方法为添加根标签、按后进先出顺序闭合标签、补全引号、使用实体引用或CDATA。可通过专业编辑器、浏览器、编程库或在线工具检测问题。掌握规则并规范书写可避免多数错误。
XML提示“格式不良好”意味着文档违反了XML的Well-Formed（良好格式）规则。这不同于“是否符合某个规范”，而是指XML文档在语法上存在错误，导致解析器无法正确读取。只要不符合Well-Formed的要求，XML就无法被解析，程序会直接报错。
什么是Well-Formed XML？
Well-Formed是XML最基本的要求，相当于写代码时不能有语法错误。一个Well-Formed的XML文档必须满足以下核心规则：
- 有且仅有一个根元素：整个文档必须被一个顶层标签包裹。
- 所有标签必须正确闭合：包括自闭合标签（如<img />）。
- 标签必须正确嵌套：不能交叉，比如<a><b></a></b>是非法的。
- 属性值必须用引号包围：单引号或双引号都可以，但不能无引号。
- 大小写敏感：<Name>和<name>被视为不同标签。
- 特殊字符需转义：如<应写成，&写成&。
常见“格式不良好”错误及修复方法
以下是实际开发中最容易出现的问题及其解决方式：
1. 缺少根元素或多根节点
<title>文章标题</title><author>张三</author>
❌ 错误：两个并列的顶级元素。
✅ 修复：用一个根标签包裹：
<title>文章标题</title>
<author>张三</author>
</article>
2. 标签未闭合或闭合顺序错误
<p><em>这是强调文本</p></em>❌ 错误：em在p之前开启，却在p之后关闭，形成交叉。
✅ 修复：按后进先出顺序闭合：
3. 属性值未加引号
❌ 错误：id和category属性没有引号。
✅ 修复：加上引号：
4. 包含未转义的特殊字符
<content>5 < 10 是正确的</content>❌ 错误：<会被误认为新标签开始。
✅ 修复：使用实体引用或CDATA：
或
<content><![CDATA[5 < 10 是正确的]]></content>如何快速检测与修复XML格式问题
手动检查容易遗漏，推荐以下方法快速定位问题：
- 使用专业编辑器：如Notepad++、VS Code、XMLSpy等，它们能高亮语法并实时提示错误。
- 通过浏览器打开XML：现代浏览器自带XML解析器，出错时会显示具体行号和错误类型。
- 编程验证：使用Python的xml.etree.ElementTree、Java的DocumentBuilder等库加载文件，捕获异常信息。
- 在线校验工具：如https://www.xmlvalidation.com/ 可粘贴内容自动检查。
基本上就这些。掌握Well-Formed规则后，大多数XML解析失败都能快速定位。关键是养成规范书写的习惯，避免手误。遇到报错不要慌，看提示行号，对照上述规则逐项排查，问题通常很快就能解决。
