git diff-tree 用于精准比对两个树对象（如提交、标签）的文件内容与模式差异，不涉及工作区或暂存区，结果稳定可复现，适用于自动化分析、审计及CI检查。
直接用 git diff-tree 可以精准比对两个历史提交的文件变更，不涉及工作区或暂存区，适合做自动化分析、审计或CI检查。
理解 diff-tree 的核心用途
git diff-tree 是底层命令，专为比较两个树对象（如 commit、tag、tree）设计。它跳过工作目录和索引，只看 Git 对象数据库中的快照差异，因此结果稳定、可复现。
常用组合是：git diff-tree -p <commit1><commit2></commit2></commit1> —— 显示补丁格式的逐行变更git diff-tree --name-only <commit1><commit2></commit2></commit1> —— 仅列出变动文件名git diff-tree -r --no-commit-id --pretty=oneline <commit1><commit2></commit2></commit1> —— 带简要提交信息的递归输出
关键参数与实用技巧
以下参数能显著提升可读性与适用性：
-
-r：递归进入子树（必须加，否则只显示顶层 tree 差异，不展开文件） -
--name-status：显示每行是A（新增）、M（修改）、D（删除）、R（重命名）等状态，比--name-only更具语义 -
-p：输出完整 diff 补丁，支持 git 工具解析（如git apply） -
--no-commit-id：避免重复打印 commit hash，配合--pretty时更干净 -
--diff-filter=AM：只筛选新增和修改的文件（支持 A/M/D/R/C/U/T/B 等字母组合）
对比特定分支/标签的实际写法
commit ID、分支名、tag 都可直接作为参数，Git 会自动解析为对应 tree：
- 对比两次 tag：
git diff-tree -r --name-status v1.2 v1.3 - 对比分支 tip 与某次提交：
git diff-tree -r --no-commit-id --pretty=oneline main abc1234 - 对比两个 merge commit 的变更集（排除合并引入的冗余）：
git diff-tree -r --cc <merge1><merge2></merge2></merge1>（需谨慎，--cc用于合并提交的特殊比较）
常见陷阱与绕过方法
diff-tree 默认不比较“空树”，比如想看首次提交（root commit）与空状态的差异，需显式使用 4b825dc642cb6eb9a060e54bf8d69288fbee4904（Git 中公认的空 tree hash）：
- 查看第一次提交引入了哪些文件：
git diff-tree -r --name-only 4b825dc642cb6eb9a060e54bf8d69288fbee4904 HEAD~2 - 如果输出为空，确认是否用了
-r；如果文件路径没显示全，加--full-tree强制从仓库根开始遍历 - 注意：diff-tree 不受
.gitattributes或core.autocrlf影响，但二进制文件默认只标“binary files differ”，加--text可强制按文本处理（慎用）
