文章介绍了如何构建一个git diff驱动程序，包括处理必要参数的方法，并以oasdiff为例进行说明。作者Jamie Tanna分享了相关技术细节，文章发布于2026年4月。

如何构建一个git diff驱动工具

作者：Jamie Tanna（软件工程师）
发布日期：2026年4月11日
原文链接：https://www.jvt.me/posts/2026/04/11/how-git-diff-driver/

核心内容

本文详细介绍了如何为git diff创建外部命令工具，用于比较文件差异。作者发现现有文档对此说明不足，因此通过实际案例分享经验。

关键要点

1. 参数处理
   git diff会向外部工具传递7个参数（而非常见的2个参数），包括：

   • 仓库中的文件名
   • 修改前/后的文件路径
   • 文件SHA-1哈希值
   • 文件八进制模式
   • 对于新建文件会使用/dev/null表示"之前"状态
   • 对于删除文件会使用/dev/null表示"之后"状态

2. 实际应用案例
   以oasdiff工具为例，展示了如何编写包装脚本来比较OpenAPI规范： ```bash

   !/usr/bin/env bash

   if [[ "$2" == "/dev/null" ]]; then echo "$1 was added" elif [[ "$5" == "/dev/null" ]]; then echo "$1 was deleted" else oasdiff changelog "$2" "$5" --color always fi ```

3. 适用场景
   这种方法适用于需要显示更丰富差异信息的场景。对于简单情况，使用textconv转换文件格式可能就足够。

补充说明

• 作者提到可以通过检查GIT_PAGER_IN_USE环境变量来处理常规参数和git diff参数
• 建议可以进一步利用SHA-1哈希值实现差异结果缓存
• 文章还包含完整的参数示例，展示文件更新、新建和删除时的不同参数组合

文章摘要：如何编写外部工具来扩展git diff的功能，用于处理复杂的文件差异比较。

（注：原文中大量导航菜单、版权声明、互动模块等非核心内容已省略，保留了技术实现的关键细节。）

总结评论内容：

1. 开发者分享个人Git工具开发经验

• gritzko分享了自己开发的基于token的git-diff工具git-dogs "I recently implemented a diff driver as part of git-dogs" "Mine is token based: https://replicated.wiki/blog/img/difflet.png"

2. 推荐其他diff查看工具

• yboris推荐了浏览器查看工具diff2html-cli "my favorite viewer is diff2html-cli which lets you see the diff in your browser"

• faangguyindia推荐Sublime Merge "Nothing beats sublime merge for this"

3. 询问多媒体文件diff工具

• tarun_anand询问是否有开源的多媒体文件diff工具 "Is there an OSS git diff for images and multimedia?"

主要观点分布： - 2人分享/推荐特定工具(git-dogs, diff2html-cli, Sublime Merge) - 1人询问多媒体diff工具 所有评论均无评分信息。