站点介绍

排查一个第三方支付回调问题,对方发来的 XML 是一整行两万多字符。编辑器里打开,光标数嵌套数到眼花——最后是贴进格式化工具展开才看见第四层少了个闭合。这一页就是那次之后做的:格式化、压缩、报错带坐标,一个工具全包。
浏览器原生的 DOMParser 解析 XML 没问题,但报错只有一个词:parsererror。哪一行?哪一列?什么错?都不给。对排障的人来说这等于没说。
所以这一页自写了解析器:逐字符扫描,标签/属性/文本/注释/CDATA/PI 分词,配对检查在语法树层做。报错时把出错位置折算成行列坐标——「3:15 属性值缺少引号」这种信息,才配叫报错。DOMParser 没扔:作为第二道对照校验,两边都过才输出(防边缘案例)。
XML 只认五个预定义实体:lt、gt、amp、apos、quot,外加数字实体(...; / ...;)。 那些是 HTML 的——在 XML 里是未定义实体,很多工具静默放行,浏览器打开直接报错。
本页遇到未定义实体就报错并给坐标,还会告诉你是哪个实体、XML 认哪些。CDATA 段里的 & 和 < 不受此限制——整块当文本,原样保留。
照着数就行:行号从 1 开始按换行符计,列号从 1 开始按字符计,指向出错的那个字符。比如「3:15 属性值缺少引号」就是第 3 行第 15 列附近有个没加引号的属性值。和 JSON 工具的报错同一套口径,改完再点一次按钮就通过。浏览器原生 DOMParser 只会给一个 parsererror,不给坐标——所以这里用自写解析器。
会。格式化输出里注释原样保留(位置跟着所在层级缩进),CDATA 段落整块不动——里面的 < 和 & 不会被动到。自闭合标签保持自闭合写法,不会被展开成一对开闭标签。命名空间前缀(如 ns:tag、xmlns:ns=...)当作普通名称的一部分处理,不会丢前缀。
不会,往返是稳定的:格式化→压缩→再格式化,第二次输出与第一次逐字符相同。原因是压缩只去掉格式化引入的缩进和换行,不碰标签内部和文本内容;文本里的空格属于内容,属于原样保留的范围。你可以拿任意输入自己跑三轮验证。
能。常见错误都在检查范围内:标签未闭合、闭合标签与开启标签不配对、属性值缺引号、裸 & 符号、未定义实体( 这类 HTML 实体在 XML 里非法)、标签名非法字符、XML 声明位置错误。区别在报错质量:DOMParser 只返回一个 parsererror 字符串不给坐标,这里给行:列。页面同时用 DOMParser 做了对照校验,两边都过才算通过。
不会。格式化、压缩、校验全部在这台设备的浏览器里完成,页面没有上传接口,断网也能用。只有缩进宽度这类选项记在本机 localStorage,换设备不跟走,页脚「清空我的数据」一键删掉。
English version: https://www.9314.cn/tools/xml-formatter/en/
评论列表 (0条)