Difftastic 语法感知差异工具

逐行 diff 的老问题

大多数代码审查都建立在 diff 的逐行文本比较之上。当一段代码只是被重新格式化、移动到另一个文件，或整体调整缩进时，传统 diff 会把这些无关改动标记为大片增删。结果是 diff 体积膨胀，真正的语义变化被淹没，审查者要么漏看关键改动，要么在噪声里疲于奔命。

结构感知差异的工作原理

Difftastic 是一个用 Rust 编写的结构差异工具，它放弃「按行对齐」的思路，转而先解析语法，再比较语法树：

• 读取文件后，按语言规范将其解析为语法树，而非文本行序列；
• 在语法树层面寻找对应的节点变化，区分实质性改动（如函数体变化、条件分支调整）与格式层面的改动（如缩进、空行、括号位置）；
• 支持 30 多种编程语言，覆盖主流的编译型与脚本型语言；
• 直接集成 git 与 mercurial，可作为版本控制流程中的 diff 后端，无需改变现有工作流。

适用边界与注意点

• 合并仍需跟踪空白字符：上游文档明确指出，即便结构差异能忽略格式变化，执行合并操作时仍需开启空白字符跟踪，否则格式差异可能引发意外冲突。
• 以可解析为前提：工具的工作基础是文件能被正确解析为语法树；对于语法不完整、正在编辑中途的代码，其表现不如成品文件可靠。
• 编辑器集成需自行确认：上游提供了 Emacs 用户的集成示例，其他编辑器用户需要自行验证接入方式。
• 该技能提取自上游 README，属于文档整理性质，核心能力完全依赖上游 Difftastic 项目本身。