1次下午输给了一个配置文件"改变"在两个部署之间,我的终端中的diff是一面红色墙,数百行,我花了一个小时寻找真正的改变,才意识到部署管道已经重新格式化了文件:重新缩进它,重新排序几个属性,重新包装一些长行,解析器会关心的一个字节实际上没有改变,除了一个单一的值埋在噪声中,基于行的diff不能告诉我这一点,因为基于行的diff不理解XML,本指南是关于比较XML应有的比较方式,使用 XML 差异检查器 在 toolz。dev 上,以及为什么结构比较会发现重要的变化,而不是淹没在格式化中。
TL;博士: XML diff 将两个文档作为节点树而不是文本行进行比较,因此重新缩进、重新排序属性或重新包装行不会注册为更改,它会报告哪些元素、属性和文本值被添加、删除或更改,每个都固定到节点路径中 XML 差异检查器 完全在您的浏览器中执行此操作,无需上传任何内容。
什么是 XML 差异检查器?
XML diff 检查器比较两个 XML 文档,并报告改变的内容作为一组结构差异:哪些元素出现或消失,哪些属性改变值,以及文本内容不同之处。它不是逐行比较文件,而是将两者解析为节点树,并将它们作为数据进行比较。您将原始内容粘贴在左侧,新版本粘贴在右侧,然后返回差异列表,每个列表都标有发生这种情况的树中的确切路径。
结构比较的重点是 XML 在许多不同的字节布局中具有相同的含义。 W3C XML 规范 is explain 一些曲面细节不影响解析的文档:元素上的属性顺序不显着,元素之间的空白通常只是格式化,两个文件在结构上可以相同,同时在缩进、属性顺序、行结尾或是否将空元素写为 <tag></tag> 或 <tag/>。纯文本 diff 标记所有这些;结构 diff 忽略它,仅显示解析器实际读取的不同内容。
Toolz。dev 上工作流程很短,粘贴两个文档,选择是否忽略空白、属性或大小写,按比较,工具对两个树进行解析,并按路径列出每个差异,分组为添加、删除和更改,新旧值并排。
XML diff 与文本 diff 有何不同?
Git 和大多数编辑器中内置的那种文本 diff 将文件作为行序列进行比较,并找到最短的一组插入和删除,将其中一个变成另一个。这对于源代码来说是完全正确的,其中行是有意义的单位。对于 XML 来说是错误的模型,其中意义存在于树中,行间断是装饰。
Failure 模式是可预测的,重新缩进文档和一个文本 diff 标记几乎每一条更改的行,在一个元素上重新排序两个属性,它会标记该行,即使该元素与解析器相同。在顶部附近添加单个子项,其下方的每行都会移动,因此 diff 显示出一系列并非真正更改的移动。您最终会扫描数百条标记的行以找到重要的行,也就是我上面描述的下午。
A structure diff sidesteps all that by parsing first。it building a tree from each document, then walk the two trees together comparing node。Formating difference simply do not existing at the tree level, so they cannot expresen in the output。reting is the set of changes that would alter the who software consuming the XML behave, which is almost always the set you actually care about。if your data is JSON rather than XML, same principle apply and the JSON 迪夫 工具在那里进行等效的结构比较。
它如何决定发生了什么变化?
每个元素的比较分三层进行,将它们分开是输出可读的原因。
Attributes按名称比较,与它们在标签中出现的顺序无关,因为属性顺序在XML中并不重要,对于每个元素,工具检查两侧存在哪些属性,并在其值不同时将属性报告为已更改,仅出现在右侧时添加,或仅在左侧出现时删除重新排序 <a x="1" y="2"/> 到 <a y="2" x="1"/> 根本没有产生任何差异。
Text 内容作为每个元素的直接文本进行比较,随着空白处理的开启,空格和换行符的运行被折叠,前后空白被修剪,因此漂亮打印文档不会创建幻象文本更改,只会报告标签之间的单词的真实更改。
Child元素是有趣的部分,共享标签名称的元素按其出现顺序配对:第一个 <item> 左边与第一个进行比较 <item> on right, the second to the second, and so on。当一侧出现次数多于另一侧时,额外内容会报告为添加或删除而不是强制错位。这种排序规则是使一个重复元素中的一个小变化从级联到每个兄弟姐妹的差异。
以下是两个比较模型的堆叠方式:
| 方面 | 文本差异 | XML 差异(结构) |
|---|---|---|
| 单位比较 | 文本行 | 树中的节点 |
| 折痕 | 显示为更改 | 被忽略 |
| 属性重排序 | 显示为变化 | 被忽略 |
| 报告更改位置 | 行号 | Node路径,例如/目录/书籍[2]/@id |
| 区分元素与属性与文本 | 否 | 是的 |
| 最好的 | 源代码,散文 | XML 配置、API 有效负载、SVG、站点地图 |
1个具体的例子,让分层清晰,拿一个小书目录,在两个版本之间,一本书's类别属性从虚构变为神秘,那本书's价格文本从12.99变为14.99,第二本书获得一个新的isbn元素,一条线diff会标记所有三个加上它们周围的任何重新缩进,混在一起,结构diff恰好报告了三个差异:类别路径处更改的属性,价格路径处更改的文本节点,isbn路径处添加的元素,每个都标有同类,所以一眼就能看出两个是对现有数据的编辑,一个是真正的添加,那个分离是阅读报告和解码报告的区别。
该工具还将结果分组为添加、删除和更改的选项卡,并带有运行计数,因此您可以首先回答粗略的问题,例如 "是否删除任何内容,"在钻入详细信息之前。在一个大文档上,此排序很重要:删除通常是最危险的变化,因为丢失的元素可以默默地剥离所需的字段,并且能够在不涉水的情况下通过不相关的编辑来隔离它们是一个实时节省器。
差异中的节点路径是什么意思?
Every difference都标上路径,告诉你它究竟在树中坐在哪里,所以你可以跳转到它而不是扫描文件,路径是由元素名称构建的,由根向下的斜杠连接,当元素有同名的兄弟姐妹时,括号中基于一个的索引会消除哪一个的歧义,所以 /catalog/book[2] 是第二本书。一个属性是用一个来写的 @ 前缀,如 /catalog/book[1]/@category并且文本更改标记为 text()、如中 /catalog/book[2]/price/text()。
这种符号故意接近 X路径、XML 文档中寻址节点的 W3C 语言,所以如果你已经读过 XPath,路径会感觉很熟悉,你经常可以将类似的表达式粘贴到自己的工具中来选择相同的节点,即使不知道 XPath,路径也会自然地读取:名字从树上下来,括号中选择一个兄弟姐妹, @ 是一个属性,并且 text() 是内容。
由于路径也命名了这种更改,因此报告一次回答了三个问题:更改了什么、它住在哪里以及它是一个元素、一个属性还是文本。这通常足以打开正确的文件并修复正确的行,而无需进一步搜索。
我什么时候才能真正使用这个?
Configuration drift 是我打得最多的案例,当一个服务在两个环境之间的行为不同,唯一的嫌疑是 XML config,比较这两个文件在结构上在几秒钟内告诉你一个值是否真正改变,或者有人只是重新格式化了文件,这同样适用于构建和部署重写 XML 的管道,在那里你需要确认一个转换只改变了它应该改变的。
API和集成工作是下一个。SOAP响应,RSS和Atom馈送,以及较旧的REST API仍然说XML,当有效负载停止正确解析时,一个结构差异与一个已知的良好样本指向违规元素快速。SVG也是XML,所以比较两个导出的图标可以准确地显示编辑器更改了哪个路径或属性。站点地图,Android布局文件,Maven POMs,和 .docx internals 都是引擎盖下的 XML,而且都受益于同样的处理,我在堆栈中构建,XML 出现在比人们预期的更多的角落,这就是为什么它住在旁边 XML格式化程序 並 XML 到 JSON 在我的书签中。我勾勒出它们如何适合更广泛的套件 JSON 到 XML 指南。
程(code-review)角度也是有的,当一个拉请求触及一个xml夹具或者一个生成的文件时,review UI中的raw diff往往是无法读取的,因为格式化程序重写了整个结构比较的前后运行,然后将短报告粘贴到review中,一眼就告诉你的reviewer实际发生了什么变化,而不是要求他们信任一面红色工具's可复制文本报告的存在正是这样:每个添加、删除和更改的节点及其前后值的紧凑摘要,准备掉入票证、提交消息或聊天线程中。
相邻的比较工具涵盖了 XML diff 不涵盖的情况。当您的数据是表格时, CSV 差异 比较行和单元格,对于两个普通列表 列表比较 tool 确实设置了差异,它们有着相同的理念:先将数据解析成自然形状,然后进行比较,因此 diff 反映了意义而不是布局。
有哪些限制?我的 XML 是私有的吗?
tool比较结构,也就是故意不报告结构不捕捉的那种差异,重新排序两个属性,改变缩进,或者交换自闭语法,都当作没有变化,通过设计,如果你的用例真的需要一个字节精确的比较,一个text diff是正确的工具,这不是结构 diff也按位置对重复的元素,所以如果将相同的记录洗牌成不同的顺序,工具会将移动的视为已更改而不是重新定位;先用一个稳定的键对两个文档进行排序,当这有意义时,给出最干净的结果。
Malformed XML被报告而不是猜测在。如果文档有不匹配或未关闭的标签,或多个根元素,工具会命名问题并告诉您它来自哪一侧,因此您永远不会从损坏的输入中获得误导性的差异。它处理常见的现实世界构造解析器必须:单引号或双引号中的属性、自闭标签、CDATA部分、注释、处理指令和标准实体引用,例如 < 並 &。
Privacy 上,所有内容都在您的浏览器中运行。两个文档都经过本地解析和比较,并且没有任何内容被上传、记录或存储。那是使区分生产配置、内部 API 有效负载或客户特定文件变得安全的属性,这些文件都不属于陌生人's 服务器。的 在线工具中的数据隐私 guide 解释了如何验证工具是真正的客户端,这在您将任何敏感内容粘贴到任何 Web 工具之前都是值得做的。
常见问题
如何比较两个 XML 文件?
XML 原来的粘贴到第一个字段,将更改的 XML 粘贴到第二个,然后按比较,工具既解析到节点树中,又列出每个添加、删除和更改的元素、属性和文本值,每个都固定到其节点路径上,没有上传任何内容。
XML diff 与纯文本 diff 有何不同?
A text diff逐行比较文件,因此重新缩进,重新排序属性或重新包装行几乎所有内容看起来都发生了变化。XML diff首先将两个文档解析为树,并在结构上进行比较,因此它仅报告会改变解析器读取文档方式的差异。
重新排序属性是否算作更改?
No。Attributes无论在标签中出现的顺序如何,都会按名称进行比较,因为属性顺序在XML中并不重要。只报告更改的值、添加的属性或删除的属性。
两个文档之间的重复元素如何匹配?
Child 元素共享一个标签名,按其出现顺序配对,所以第一个项与第一个项、第二个到第二个比较,依此类推,如果一个文档出现次数比另一个多,则额外内容按添加或删除的方式报告。
每个差异中的节点路径是什么意思?
Path 显示在树中的变化在哪里,使用元素名称,当有同名的兄弟姐妹时,括号内为一个基于一个的索引,@name 为一个属性,text() 为文本内容,例如/catalog/book[2]/@id 指向第二本书的 id 属性。
空格或格式化是否会影响比较?
By 默认只留白度的文本被忽略,文本内部的空白运行被折叠,因此重新格式化文档不会产生虚假的差异,您可以依靠结构比较而不是精确匹配缩进。
XML 格式错误会发生什么?
该工具报告了一个明确的错误命名问题,例如不匹配或不封闭的标签,并告诉您它来自哪个文档。它不会猜测修复,因此您永远不会从损坏的输入中获得误导性的差异。
我的 XML 文档是否上传到任何地方?
No。所有的解析和比较都发生在你的浏览器中,JavaScript。没有传输,记录或存储任何内容。您可以通过查看网络选项卡或通过断开与互联网的连接来确认这一点,该工具保持离线工作。
将您自己的文档与免费文档进行比较 XML 差异检查器。它按节点路径报告结构差异,完全在浏览器中,没有任何上传内容。
