XML入门阶段的第二个常见问题是不了解XML文档的基础结构规范，编写出的文档不符合语法要求，导致解析器无法正常读取内容，这也是很多新手刚上手时最容易踩的坑。
XML文档的基础结构要求
一个符合规范的XML文档需要包含几个核心部分，缺少任意部分或者格式错误都会引发问题。
1. XML声明
XML声明是文档的第一行内容，用来指定XML的版本和编码格式，虽然部分解析器可以兼容没有声明的文档，但规范编写时必须添加。声明格式为<?xml version="1.0" encoding="UTF-8"?>，其中version是必填属性，encoding如果不指定默认使用UTF-8编码。
2. 根元素
XML文档必须有且仅有一个根元素，所有其他元素都必须包含在根元素内部，不能存在游离在根元素之外的内容。比如下面的示例中，<user>就是根元素，内部的<name>和<age>都是它的子元素。
3. 标签闭合规则
所有的XML标签必须成对出现，要么使用开标签和闭标签的组合，要么使用自闭合标签。标签名区分大小写，<Name>和<name>会被解析器识别为两个不同的标签。
4. 属性值要求
元素的属性值必须使用英文双引号或者单引号包裹，不能省略引号，也不能混用引号。比如<user id="1">是合法的，而<user id=1>或者<user id='1">都是不合法的。
常见错误示例和修正方法
下面列举几个新手常犯的结构错误，以及对应的修正后的正确写法。
错误1：缺少根元素
错误写法：
<?xml version="1.0" encoding="UTF-8"?> <name>张三</name> <age>20</age>
上面的代码里有两个同级元素，没有统一的根元素，解析器会直接报错。修正后的正确写法：
<?xml version="1.0" encoding="UTF-8"?>
<user>
<name>张三</name>
<age>20</age>
</user>
错误2：标签未闭合
错误写法：
<?xml version="1.0" encoding="UTF-8"?>
<user>
<name>张三
<age>20</age>
</user>
这里的<name>标签没有对应的闭标签，修正后需要补充</name>。
错误3：属性值没有引号
错误写法：
<?xml version="1.0" encoding="UTF-8"?>
<user id=1>
<name>张三</name>
</user>
属性id的值1没有加引号，修正后需要写成id="1"或者id='1'。
如何验证XML文档的合法性
编写完XML文档后，可以通过解析器验证文档是否符合规范。下面是一个使用Python的xml.etree.ElementTree模块验证XML的示例：
import xml.etree.ElementTree as ET
def validate_xml(file_path):
try:
# 尝试解析XML文件
tree = ET.parse(file_path)
print("XML文档结构合法，解析成功")
return True
except ET.ParseError as e:
print(f"XML文档结构错误：{e}")
return False
# 调用验证函数，传入XML文件路径
validate_xml("test.xml")
如果XML文档存在结构问题，解析时会抛出ParseError异常，并提示具体的错误位置和原因，方便我们快速定位修正。
编写XML的注意事项
- 始终在文档开头添加XML声明，明确版本和编码
- 保证文档有且仅有一个根元素，所有子元素都嵌套在根元素内
- 所有标签都要正确闭合，标签名保持大小写统一
- 属性值必须加引号，避免混用单双引号
- 特殊字符如<、>、&需要转义，或者使用CDATA块包裹内容
掌握XML文档的基础结构规范后，就能避免入门阶段的第二个常见问题，后续学习XML的解析、转换、约束定义等内容时也会更加顺畅。