文本对比指南:行差异、空白、大小写与报告
Admin ·
ToolMellow 文本对比工具在浏览器中逐行比较原版与修改版。粘贴两段文本,决定大小写或空白差异是否影响匹配,再选择“对比文本”。结果按源文本行号标出新增、删除和未变行。
可用它检查草稿、配置片段或预期输出的编辑。匹配结果只说明两段文本在当次使用的选项下行内容匹配,不证明原始文件字节相同、程序行为等价或编辑正确。发现变化时,可复制或下载普通文本对比报告。
比较原版与需要审查的版本
把较早版本放入“原文本”,较新版本放入“修改后的文本”。两个输入初始为空,两个选项初始关闭。选择“对比文本”计算结果。只有两个输入值都为空时按钮才不可用;空格仍算输入,也支持一侧非空、另一侧为空的对比。
可用小示例:原文本三行分别为 alpha、beta 和 gamma;修改后一侧使用 alpha、gamma 和 delta。报告保留 alpha 和 gamma,删除 beta,新增 delta。gamma 旁的两个行号不同,因为删除后它从第三个位置移到了第二个。
- 每条行内容差异都重要时,先关闭两个忽略选项。
- 有意识地选择选项,执行对比,再检查计数和标记行。
- 修改文本或选项后,应再次对比再复制结果。
读懂两列行号与变化标记
第一列行号属于原文本,第二列属于修改后的文本。未变行有两个行号,删除行只有原文行号,新增行只有修改后行号。行号从一开始数逻辑输入行;编辑器或报告中视觉折行的长行不会因此多出一个行号。
视觉删除标记是 −,导出报告的删除前缀则使用普通 ASCII -。增删行也有供辅助技术读取的文字标签。摘要统计此对齐方式中的行数,不是改动字词、字符、相似度百分比或编辑的重要程度。
| 行类型 | 原文列 | 修改后列 | 含义 |
|---|---|---|---|
| 未变 | 行号 | 行号 | 行比较键在所选选项下匹配。 |
| 删除 | 行号 | 空 | 原文行在对齐中没有匹配。 |
| 新增 | 空 | 行号 | 修改后行在对齐中没有匹配。 |
替换通过整行表示
改动一个词可能生成一条删除行和一条新增行。此版本不在行内突出显示改动的词。它对齐有顺序的匹配行序列,所以移动一个段落也可能表现为增删,而不是专门的移动区块标签。
引擎排除匹配的开头和结尾后,寻找比较键的最长公共子序列。重复行可能产生几个同样长的对齐方案。剩余选择长度相同时,此实现先取删除。这个确定性的选择不能证明作者原本想进行某次移动或替换。
忽略大小写比较小写形式
“忽略大小写”对每行的比较键应用 JavaScript 默认小写转换。开启后,Alpha 可与 alpha 匹配。它不会修改两个输入,也不会把复制文本改成小写。未变行保留修改后一侧的原始文本。
默认小写转换不是完整的 Unicode 大小写折叠,也不是某种语言特定的搜索规则。Straße 与 STRASSE 仍不同,拉丁 I 也不会变成土耳其语无点 ı。希腊 sigma 的不同形式转换后也可能不同。应按该选项实际消除的差异来选择,不要假设所有语言的无大小写形式都会相等。
忽略空白逐行去掉首尾并压缩连续空白
“忽略空白差异”先去掉已分割各行两端的空白,再把剩余连续 JavaScript 空白替换为一个普通空格。因此,制表符、重复空格和不换行空格可与一个空格匹配。若同时忽略大小写,小写转换发生在此空白处理之后。
此选项不会删除每个空格:ab 与 a b 仍不同。它不会从序列中删除空行,也不会合并相邻行。JavaScript 空白规则不会自动去掉零宽空格。审查内容的缩进或精确空白有意义时,应避免此选项。
用已知的小示例选择选项
这些示例描述比较键,不是对输入进行编辑。对比大段内容前,先试一条有代表性的行。即使比较键经过首尾去空白、压缩或小写转换,未变输出行也保留右侧原始内容。
| 原文/修改后 | 选项 | 结果 |
|---|---|---|
Alpha / alpha | 两个选项关闭 | 一条删除行与一条新增行。 |
Alpha / alpha | 忽略大小写 | 一条未变行,保留 alpha。 |
alpha beta / alpha beta | 忽略空白 | 一条未变行,保留 alpha beta。 |
ab / a b | 忽略空白 | 不同:比较键保留一个空格。 |
Straße / STRASSE | 忽略大小写 | 不同:小写转换不是完整大小写折叠。 |
| 空行/含空格的行 | 忽略空白 | 两行可以匹配,不会删除任何一行。 |
处理换行后再比较行内容
对比引擎在 CRLF、CR 或 LF 处分割传入字符串。浏览器 textarea 值通常在传给组件前,将换行规范化为 LF。因此,Windows 风格换行的文件与 LF 文件可得到匹配的行。本页面不是原始文件编码、字节顺序标记或逐字节一致性的检测器。
末尾分隔符有意义,因为分割非空字符串会留下最后一个空行。例如 alpha 与 alpha\n 不同,后者写法表示 alpha 后跟实际换行。完全空的输入没有任何行,只有一个换行的输入则有两个空行。窄屏幕上的软折行不会增加一条对比行。
外观相似不保证文本匹配
Unicode 可以用一个码点表示带重音字母,也可以用基础字母后接组合符号表示。两种字符串可能看起来相同,此对比器却认为不同。两个选项都不执行 Unicode 规范化、不去掉重音,也不处理不同文字体系中外观相似的字母。
输入与结果文本采用自动文字方向,行号则保持从左到右。混合阿拉伯文、希伯来文、拉丁文和标点时,会按双向文字规则显示。不可见或混合方向差异重要时,应在合适的编辑器中检查源字符;报告不是码点查看器。
输入限制统计 UTF-16 代码单元
每侧最多接受 1000000 个 UTF-16 代码单元。JavaScript 字符串长度与 textarea maxlength 使用此计量方式。许多常见字符占一个单元,补充字符如 😀 占两个;一个可见的组合字符还可能占更多。这不是一百万字节或一百万可见字符的额度。
浏览器限制正常用户输入,引擎也独立拒绝超过上限的字符串。粘贴大段文本后,应检查末尾,不要假设每个源字符都已被接收。没有文件导入、流式对比或批量界面。审查大文档时,可选取较小的相关片段。
行数限制取决于剩余的比较矩形
引擎先排除开头和结尾相等的键序列,再将剩余两侧行数相乘。乘积超过 4000000 时,会拒绝并提示比较较短片段。该乘积是准入检查;实际分配的表还多一个边界行和边界列。
没有通用的每侧 2000 行上限。两组完全不同的 2000 行乘积是 4000000,可通过此检查;2001 乘 2001 则超过限制。不对称的 1000 乘 4000 也达到允许边界。更长的两段文本若只在中间有少量差异,剩余矩形可能很小。每侧仍必须满足独立的文本长度限制。
| 剩余原文行数 | 剩余修改后行数 | 乘积 | 乘积检查 |
|---|---|---|---|
2000 | 2000 | 4000000 | 允许。 |
2001 | 2001 | 4004001 | 拒绝。 |
1000 | 4000 | 4000000 | 允许。 |
1000 | 4001 | 4001000 | 拒绝。 |
0 | 5000 | 0 | 此检查允许,文本长度限制仍适用。 |
选择对应片段缩小被拒绝的任务
剩余行数乘积过大时,应从两个版本中选取相关片段对比。保留足够的共有语境,以辨认片段在原文中的位置。此时计数和行号描述粘贴的片段,而不是完整原始文档中的位置。
通过大小检查不保证每台设备都能即时渲染。很多输出行或长行仍需要浏览器内存和布局工作。忽略选项可能改变匹配的边界,但只有语义适合任务时才应开启,不要为绕过限制而隐藏重要差异。
复制和下载生成完整的带前缀文本报告
结果有变化时,报告包含每一条结果行,包括未变的上下文。新增行以加号和空格开头,删除行以 ASCII 连字符和空格开头,未变行以两个空格开头。各行用 LF 连接。报告不包含界面中的行号列或图例。
原文的 alpha、old 两行与修改后的 alpha、new 两行对比时,复制得到 alpha\n- old\n+ new;显示的换行记法代表实际换行。复制不会再附加一个换行。下载会多加一个 LF,并保存名为 toolmellow-comparison.txt 的 UTF-8 普通文本文件。最后一行若表示空输入行,该行前缀仍是报告的一部分。
用报告审查,用补丁流程应用修改
常见的加减标记不代表这是 GNU 或 Git unified patch。报告没有文件头或区块范围,包含所有未变行,并在每个变化标记后多一个空格。把它交给补丁应用工具不是受支持的流程。
若仓库修改需要他人应用,应通过相应版本控制工具生成并检查补丁。ToolMellow 报告可作为易读的对比附件,但不合并编辑、不保留原文件元数据,也不重建原文件的字节编码。
匹配使用当次对比的选项
对齐结果没有增删行时,工作区显示匹配提示,并隐藏行列表、“复制对比结果”和“下载对比结果”。原始输入字符串仍可能因忽略大小写、忽略空白或规范化换行而不同。
若匹配结果出乎预期,可关闭两个忽略选项并再次对比。仍应注意按行输入的边界:即使严格选项设置也不对比原文件字节或执行语义验证。匹配不代表批准配置、合同、译文或代码。
编辑不会自动重新计算显示的结果
输入文本或修改选项会保留之前的结果、错误和提示。复制与下载仍使用该显示结果。编辑后应选择“对比文本”;成功对比替换结果并清除反馈,失败则移除旧结果并显示错误。
“试用示例”会将两个字段填为英文样本,清除之前的结果、错误和提示,保留两个选项,并等待你执行对比。“清空”删空两个字段,移除结果和错误并显示清空提示,也保留选项。两种操作都不会删除已复制到系统剪贴板或下载的报告。
剪贴板写入不可用时使用下载
“复制对比结果”请求浏览器将当前报告写入剪贴板。可用性取决于浏览器权限和环境。写入失败会提示使用“下载对比结果”。成功提示说明尝试复制的报告,不代表重新对比了之后编辑的输入。
下载会用同一份报告多加一个末尾 LF 来启动浏览器下载。文件保存在哪里、是否弹出保存提示以及如何打开,由浏览器和操作系统决定。本工具没有 PDF、富文本、HTML 或合并文件导出。
对比在页面中运行,报告可主动导出
对比代码在本地使用两个输入字符串,没有对比上传请求。加载网站仍会请求普通页面和资源。本地计算不等于访问网站不产生网络流量,也不代表每个扩展程序和设备都有独立隐私保证。
工作区不提供保存的对比历史或分享链接。重新加载页面会开始新工作区。复制主动把报告放入剪贴板,下载主动创建文件,应按审查文本的处理需求选择这些操作。
通过对比定位编辑,再判断其含义
审查文章时,应结合上下文阅读每条增删行。审查配置或预期程序输出时,应先精确比较大小写和空白,除非接收系统明确忽略它们。改动一行可能修复错误,也可能引入错误;此对比器不执行代码、不解析数据格式,也不评估正确性。
文本清理、大小写转换和字数统计是可帮助准备或检查的独立工具。它们不会自动接收此工作区的任何一侧输入。在其他地方清理内容时,应保留原版本,避免准备步骤悄然成为本来打算审查的改动。
常见问题
如何对比文本的两个版本?
较早版本粘贴到“原文本”,较新版本粘贴到“修改后的文本”,选择大小写和空白选项,再选择“对比文本”。查看标记行及其原文和修改后行号。
改动一行为什么可能显示两次?
工具按整行报告。替换可能表现为删除原文行并新增修改后行,不在行内高亮具体改动字词或字符。
忽略空白会删除所有空格吗?
不会。它去掉各行首尾空白,并将连续 JavaScript 空白压为一个空格。ab 与 a b 仍不同,空行也保留在序列中。
看起来不同的文本也能匹配吗?
可以。忽略大小写或空白可让比较键相等,原始字符串仍不同。换行也在比较行内容前处理。关闭两个选项并重新对比,可查看较严格的行差异。
末尾换行为什么算变化?
非空输入若以行分隔符结尾,会产生最后一个空行。它可以像其他行一样被新增或删除,即使没有可见字母。
下载的对比报告是补丁文件吗?
不是。它是完整的带前缀文本报告,没有文件头或区块范围。需要可应用的补丁时,应使用合适的版本控制或补丁工具。
是否有每侧 2000 行限制?
没有固定的每侧 2000 行限制。排除相等的开头和结尾后,两侧剩余行数乘积最多为 4000000。每侧还受 1000000 个 UTF-16 代码单元限制。
编辑后为什么仍显示旧结果?
工作区在选择“对比文本”时计算,不是每次编辑都计算。修改输入或选项会保留旧结果。复制或下载更新报告前,应再次对比。
对比时会上传我的文本吗?
对比在本地执行,不上传两段文本。网站仍通过正常页面和资源请求加载。复制和下载会主动把报告导出到剪贴板或文件。
为什么没有复制对比结果?
只有当前结果包含增删行时才出现复制与下载。匹配时仅显示提示,不提供导出报告;没有执行或执行失败的对比也没有可导出的结果。
忽略大小写在所有语言中都一样吗?
它使用 JavaScript 默认小写转换,不是完整的 Unicode 大小写折叠或按语言匹配。有些大小写相关形式仍不同,包括 Straße 与 STRASSE。
复制和下载报告完全一样吗?
它们包含相同的前缀行。下载在末尾多加一个 LF,并保存为 toolmellow-comparison.txt;复制不额外增加末尾换行。两者都不包含界面显示的行号。
能对比文档、合并编辑或计算相似度吗?
工作区接受粘贴文本并报告行差异,不导入文档文件、不合并变化、不应用补丁,也不计算相似度百分比或检查抄袭。
试用示例或清空输入会怎样?
示例替换两个输入并清除结果和反馈,保留选项。“清空”删空输入、移除结果和错误、显示清空提示,也保留选项。已有剪贴板内容和下载文件不受影响。