Difftastic 是一个结构化的差异比较工具,它根据文件的语法来比较文件。
基本示例
在这个 JavaScript 示例中,我们可以看到:
(1) Difftastic 理解嵌套。它突出显示匹配的 {
和 }
,但理解 foo()
尽管有前导空格也没有发生变化。
(2) Difftastic 理解哪些行应该对齐。它将左侧的 bar(1)
与右侧的 bar(2)
对齐,即使文本内容不完全相同。
(3) Difftastic 理解换行不具有实际意义。"eric"
现在在新的一行上,但它并没有改变。
一分钟演示
这个一分钟的屏幕录像演示了 difftastic 在独立文件和 git 中的使用。
支持的语言
Difftastic 支持超过 30 种编程语言,完整列表请参见手册。
如果文件扩展名无法识别,difftastic 会使用带有单词高亮的文本差异比较。
已知问题
性能:Difftastic 在处理变更较多的文件时,扩展性相对较差,可能会使用大量内存。
显示:Difftastic 采用并排显示,通常效果不错,但有时可能会造成混淆。
稳定性:Difftastic 定期发布修复崩溃的版本。
非目标
生成补丁:Difftastic 的输出旨在供人阅读,不会生成可以后续应用的补丁。如果需要补丁,请使用 diff
。
(补丁文件也是面向行的,这对 difftastic 来说过于局限。Difftastic 可能会在同一行发现添加和删除,它还会跟踪旧文件和新文件中行号之间的关系。)
合并:AST 合并是一个复杂的问题,difftastic 不涉及这个领域。
常见问题
这不就是基本上等同于 --word-diff --ignore-all-space
吗?
词级别的差异比较做不到这一点。
Difftastic 会解析您的代码。它理解何时空白字符很重要,比如在字符串字面量内或像 Python 这样的语言中。它理解 x-1
在 JS 中是三个标记,但在 Lisp 中是一个标记。
我可以在 git 中使用 difftastic 吗?
当然可以!difftastic 手册中包含了 git 使用说明。您也可以在 mercurial 中使用它。
如果您是 magit 用户,可以查看这篇博客文章,它展示了在 magit 中使用 difftastic 的一种方法。
difftastic 能与我喜欢的工具集成吗?
可能不能。Difftastic 还很年轻。考虑为您喜欢的工具编写一个插件,我会在 README 中链接它!
difftastic 能帮助我解决合并冲突吗?
可以!从 0.50 版本开始,difftastic 能够理解合并冲突标记(即 <<<<<<<
、=======
和 >>>>>>>
)。
将带有冲突的文件作为单一参数传递给 difftastic。Difftastic 会构造两个冲突的文件并比较它们。
$ difft file_with_conflicts.js
difftastic 能进行合并吗?
不能。AST 合并是一个复杂的问题,difftastic 不涉及这个领域。
从文本差异的角度来看,AST 差异比较是一个有损的过程。Difftastic 会忽略在语法上不重要的空白字符,但合并需要跟踪空白字符。
difftastic 能忽略重排序吗?
不能。Difftastic 始终认为顺序很重要,所以比较 set(1, 2)
和 set(2, 1)
时会显示变化。
如果您要比较 JSON,可以考虑在传递给 difftastic 之前对键进行排序。
$ difft <(jq --sort-keys < file_1.json) <(jq --sort-keys < file_2.json)
另请参阅手册中的棘手情况:无序数据类型。
我可以使用 difftastic 检查语法变化而不进行差异比较吗?
可以。Difftastic 可以检查两个文件是否具有相同的 AST,而无需计算差异。这比正常的差异比较快得多,对于构建检查变化的工具很有用。
例如:
$ difft --check-only --exit-code before.js after.js
如果没有语法变化,退出码将设置为 0;如果发现变化,退出码将设置为 1。
为什么颜色没有在我的终端中显示?
Difftastic 默认使用 ANSI 亮色,但某些终端主题将亮色显示为灰色。Solarized 是一个常见的这样做的主题。
如果您是 Solarized 用户,请使用 export DFT_BACKGROUND=light
来禁用亮色,或尝试其他终端配色方案。
它是如何工作的?
Difftastic 将结构化差异比较视为一个图问题,并使用 Dijkstra 算法。
翻译
许可证
Difftastic 在 MIT 许可证下开源,有关详细信息,请参阅 LICENSE。
本仓库还包括 vendored_parsers/
目录中其他作者的 tree-sitter 解析器。这些解析器使用 MIT 许可证和 Apache 许可证的混合。有关详细信息,请参阅 vendored_parsers/*/LICENSE
。
sample_files/
中的文件也采用 MIT 许可证,除非它们的头部另有说明。