配置文件里加一条注释分隔线,看似没有碰任何元素,XML却突然无法解析。注释不是任意文本容器,连续两个连字符有明确限制;从终端输出或别的文档复制一串横线进去,容易触发这个问题。

2026年11月19日,在XML格式化工具输入note元素,注释文字使用build与ready之间的双连字符。当前页面报告XML解析错误,位置指向注释内部的双连字符。把中间改成单个连字符后,同一结构可以格式化,value元素仍保存demo。

当前工具明确报告注释内部的双连字符错误;元素外观完整不能代替注释语法检查
当前工具明确报告注释内部的双连字符错误;元素外观完整不能代替注释语法检查

起止标记合法,不代表内部任意

XML规范禁止注释内容包含连续两个连字符,注释也不能用一个紧贴结束标记的额外连字符形成三连字符结尾。这里限制的是注释语法,不是元素文本里所有连字符都不能出现,也不是说不能使用正常的单连字符说明。

本机DOMParser对照中,含双连字符的注释出现parsererror;改为build-ready后可以读取注释节点。另一个把单连字符与结束标记之间留有空格的样例也能读取。区分“注释内容里的符号”和“结束标记本身”,比把所有横线删除更准确。

本机解析记录对照非法双连字符、普通单连字符与结束标记前保留空格的结果
本机解析记录对照非法双连字符、普通单连字符与结束标记前保留空格的结果

注释不是用来绕过字符规则的

不要尝试在注释里写字符引用,期待解析器先把它替换成连字符再组成分隔线。注释内容不会像普通元素文本那样解释实体引用;那样得到的往往只是字面文字,也不能解决原本想展示的排版问题。需要装饰分隔时,直接使用不含禁用序列的说明即可。

修改后重新校验完整文档,再核对注释前后的节点是否还在。报错行列帮助定位解析停止处,不一定意味着这一行的元素名称错了。尤其是复制多段配置时,应把注释和前一个标记一起查看,避免只改后面的闭合标签。

关于格式化、压缩和一般报错流程,可以参考XML校验的基本操作。本次实验只验证注释语法和当前工具的反馈,没有把“可以格式化”扩展成配置项已满足业务要求。