深度解析：如何构建 `git diff` 驱动程序及应用示例
【导语：Jamie Tanna 撰写文章介绍如何为 `git diff` 创建用于文件差异比较的外部命令。因相关文档缺乏，作者结合自身实践与他人启发，详细阐述构建方法及使用 `oasdiff` 工具的示例，为开发者提供参考。】
自 2024 年 11 月起，Jamie Tanna 就想写一篇关于为 `git diff` 创建外部命令用于文件差异比较的文章。在实现 `renovate-packagedata-diff` 时，他发现相关文档稀缺，虽后来在 [Git Diffs 手册页](https://git-scm.com/docs/git#_git_diffs)中找到一些内容，但并不容易发现。近期 Andrew Nesbitt 发表的关于 [Git Diff 驱动程序](https://nesbitt.io/2026/03/30/git-diff-drivers.html)的文章给了他启发，促使他撰写本文。
`git diff` 会向其调用的外部工具传递 7 个参数，这与很多工具直接以 `tool [before] [after]` 方式运行不同。在更新现有文件、添加或删除文件时，参数情况各有不同。
当现有文件被更新时，参数包含仓库中的文件名、“修改前”和“修改后”的文件路径、对应文件的 SHA - 1 哈希值以及八进制模式。当创建新文件时，“修改前”的文件为 `/dev/null`，不相关参数用 `.` 表示；当删除文件时，“修改后”的文件为 `/dev/null`，不相关参数同样用 `.` 表示。此外，查看环境变量 `GIT_PAGER_IN_USE` 是否设置，有助于命令处理常规参数和 `git diff` 的参数。
有了上述信息，就可以围绕 [`oasdiff`](https://github.com/oasdiff/oasdiff) 工具编写轻量级包装脚本用于比较 OpenAPI 规范。最基本的实现脚本会判断文件是添加还是删除的情况，若文件添加则输出“已添加”，若文件删除则输出“已删除”，若文件更新则使用 `oasdiff changelog` 命令并始终显示颜色。
不过，该脚本没有处理权限的变化，并且使用文件的 SHA - 1 校验和来缓存差异结果可能也是有必要的。
编辑观点：本文为开发者提供了构建 `git diff` 驱动程序的详细指导，填补了相关文档的空白。通过具体示例，清晰展示了如何处理不同情况下的参数及应用工具，对提高文件差异比较效率有重要意义。