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 命令参数详解。