文本比对与忽略规则指南 — 序匣

用一份配置，走完比对流程

把两个版本分别放到左右两侧，按内容序列对齐，再定位新增、删除与修改。不需要逐行来回寻找，也不会因为插入一行就把后面全部当成变化。

01 · 原始版本放左边，新版放右边

文件信息显示 UTF-8 BOM、原始大小、当前换行和页面修改状态。下载当前文件保留 BOM 和换行；原文补丁描述解码后的文本差异。两份 JSON 可以转到结构比对，再返回查看原文，内容和规则保留在当前标签页内存中。

可以使用 Cmd / Ctrl + Enter 执行当前任务。手机上切换输入标签来编辑两边，再查看差异结果。

原始文本

service = "api"
mode = "dev"
retries = 2
port = 8080

新文本

service = "api"
mode = "production"
retries = 3
port = 8080
healthcheck = true

+ 1 行新增− 0 行删除~ 2 行修改

mode 与 retries 是相邻的两行修改，healthcheck 是一行新增。未变化的 port 把它们分隔成两个变更块。

忽略规则只决定“怎样判定相同”。它不会修改输入，也不会把复制的原文变成已经清理过的文本。

规则	何时使用	实际影响
不忽略空白	需要精确核对配置或文字内容。	保留缩进、行尾和行内空白差异。
忽略行尾空白	保存文件时出现无意义的尾部空格。	只忽略一行结尾的空白，保留缩进和内部空格。
忽略缩进	只调整了段落或代码行的缩进。	只忽略行首空白，保留行内与行尾差异。
忽略全部空白	明确只关心行内非空白字符。	忽略行内空白；字符串内部的空格也会被忽略。
忽略大小写	当前任务约定大小写没有意义。	比较时使用不区分大小写的规则，原文不变。
忽略换行类型	Windows 与其他系统的换行方式不同。	CRLF、LF、CR 作为同一种行尾；末尾有无换行仍可构成差异。

核对 JSON 或配置值时，谨慎使用“忽略全部空白”。例如字符串中的一个空格和两个空格可能有业务意义，也会被这个文本规则忽略。

告诉你涉及多少行。相邻删除与新增中的可配对部分计为修改，剩余计为纯新增或纯删除。

表示连续发生变化的区域。导航按块跳转，一块里可以包含多行修改。

删除会同时显示 − 标记和删除色，新增使用 + 标记和新增色；修改行还会强调行内改变的字符。你可以结合符号、位置与颜色来阅读结果。

遇到特别长的单行，工具可能降低行内细节以控制计算量。输入体积、行数或运行时间超过保护范围时，会明确提示；原文仍然保留，可以缩小范围后再次比较。

明明看起来不同，为什么显示没有有效差异？

检查当前忽略规则。例如开启忽略大小写后，hello 和 HELLO 会视为相同。关闭相关选项再比较，就能检查被忽略的部分；输入原文从未被修改。

只有一边有内容，也能比较吗？

可以。只有新版内容时显示新增，只有原始内容时显示删除。两个文本输入都为空且未导入文件时保持空状态；两个已加载的空文件也可以比较。

可以比较两个 PDF 或 Word 文件吗？

不能直接解析这类文档。当前支持纯文本内容和 UTF-8 文本文件，可以先从文档中复制需要检查的文字。

两个 JSON 的键顺序不同，会被标出吗？

会。文本比对关注字符与行的排列。需要忽略对象键顺序、按字段检查数据变化时，可使用“JSON 结构比对”，再选择比较精确值或原始写法；数组按索引匹配。

相关说明：浏览器本地处理与数据保留规则。本工具的文本比对不判断自然语言是否“意思相同”。