Project Icon

difftastic

基于语法分析的结构化文件对比工具

difftastic是一款基于语法分析的结构化文件对比工具。它支持30多种编程语言,能识别代码嵌套、行对齐和换行等特性,提供智能化的差异展示。difftastic可与Git和Mercurial集成,支持合并冲突解析。虽然性能和稳定性有待提升,但它为开发者带来了新颖的代码比对方式。

它太棒了!
英文手册 中文手册 crates.io codecov.io

Difftastic 是一个结构化的差异比较工具,它根据文件的语法来比较文件。

有关安装说明,请参阅手册中的安装部分。

基本示例

Difftastic 和 JS 的截图

在这个 JavaScript 示例中,我们可以看到:

(1) Difftastic 理解嵌套。它突出显示匹配的 {},但理解 foo() 尽管有前导空格也没有发生变化。

(2) Difftastic 理解哪些行应该对齐。它将左侧的 bar(1) 与右侧的 bar(2) 对齐,即使文本内容不完全相同。

(3) Difftastic 理解换行不具有实际意义。"eric" 现在在新的一行上,但它并没有改变。

一分钟演示

asciicast

这个一分钟的屏幕录像演示了 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 许可证,除非它们的头部另有说明。

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号