git show 用来「展开一个对象」:给它一个提交,就显示那次提交的元信息和完整 diff;给它标签、树或文件对象,也能按对应形式展开。git show HEAD 大概是复查「我刚刚提交了什么」最快的方式。

本文列出 git show 的常用参数,并说明它与 git log -p、git diff 的分工。

ℹ️
关于本系列
本文是《Git 使用教程》按命令拆分的第 9 / 28 篇,全部收录在 Git 栏目。参数表列的是日常高频项,并非穷举;想看某个命令的完整参数,用 git show -h 看精简列表、git help show 看完整手册。示例以 Git 2.56.0 为准。

一、命令语法

先看语法骨架,再对照下一节的参数表。<占位> 表示必填值,实际输入时不要带尖括号;[...] 表示可选项,-- 用来分隔选项与路径。

bash语法
git show [<options>] <object>...

二、参数逐项详解

下表按用途列出 git show 的常用参数,每项都注明了「它到底改变了什么」。

参数 / 写法作用
<object>提交、标签、分支、HEAD~n、<commit>:<路径> 都可以
--stat / --shortstat只显示改动文件统计,不展开完整 diff
--name-only / --name-status只列改动文件名 / 带 A M D 状态
-p / --patch显示完整 diff(对提交对象默认开启)
--pretty=<格式> / --format自定义提交信息的输出字段
-s / --no-patch只显示提交信息,完全不显示 diff
--word-diff / --color-words按词显示差异
--check检查该提交是否引入空白错误
--abbrev-commit显示短哈希
--first-parent合并提交只沿第一父提交展开
-- <路径>只显示该路径相关的改动

三个「看 diff」命令怎么选

命令适合
git show <commit>看某一次提交的完整内容与说明
git log -p看一批提交各自的 diff
git diff A..B看两个状态之间的净差异,不关心中间过程

三、常用示例

复查最近几次提交

bash复查最近几次提交
git show --stat HEAD
git show HEAD~1
git show -s --format="%h %an %ad %s" --date=iso HEAD

看某个文件在历史提交里的内容

bash看某个文件在历史提交里的内容
git show HEAD~3:src/config.js
git show v1.2.0 --stat
git show --name-status a1b2c3d -- src/

四、注意事项

不用切分支也能看老版本文件: git show <commit>:<路径> 直接把那个版本的文件内容打印出来,配合重定向 > /tmp/old.js 就能拿到副本,比 checkout 来回切安全得多。
ℹ️
标签对象要加 -s 才只看到说明
附注标签本身是一个对象,git show v1.0 会先显示标签信息再显示对应提交的 diff;只想看标签说明可以用 git show -s v1.0。

五、小结

git show 是「单点放大」工具:先靠 git log 找到提交,再用它展开细节。参数主要控制「展开到什么程度」——-s 只要信息、--stat 要统计、-p 要全文。

本系列共 28 篇,一个命令一篇,完整目录见 Git 栏目。下一篇:git blame 命令参数详解。