git show

git show 用来展开查看一个具体对象。最常见的是看某次提交的作者、说明和 diff，但它也可以查看 tag、tree 甚至 blob。

什么时候最常用

• 想快速看一条提交到底改了什么
• 想核对某个 tag 指向哪个提交
• 想把 HEAD~1、main、某个 commit hash 展开成可读信息

常见写法

git show HEAD
git show HEAD~1
git show v1.2.0
git show --stat <commit>
git show --name-only <commit>

应该怎么理解它

把 git log 理解成“列出很多提交”，把 git show 理解成“把某一个对象打开看细节”会更直观。

最实用的几个参数

• --stat：看文件级改动摘要
• --name-only：只看改动到哪些文件
• --name-status：看新增、删除、修改状态
• --no-patch：只看提交元数据，不看 diff

常见误区

git show 只能看提交

不是。它本质上是看对象，只是最常用在 commit 上。

它会修改仓库状态

不会。git show 是纯读取命令，适合在排查和 review 时放心使用。

这条命令在流程里解决什么问题

从流程位置看，git show 更像“先观察、再决定”的命令。它通常不直接改写历史，而是帮助你确认工作区、暂存区、引用或提交对象当前到底处于什么状态。

典型用例

• 在 review 代码或排查问题时，用 git show 快速查看某个提交的具体改动。
• 把 git show 放进代码评审、排障和复盘流程，帮助团队对齐上下文。
• 当你需要解释“现在仓库为什么会这样”时，让 git show 先输出可验证的信息。

图例理解

观察对象

工作区暂存区提交历史引用

→git show

产出

控制台信息差异上下文决策依据

如果输出看起来“不对”，优先排查的是观察范围，而不是命令本身有没有生效。

特殊情况与边界

• 大多数观察命令本身不改历史，但它看到的结果会受 HEAD、路径、提交范围或引用选择影响。
• 如果 git show 的输出和预期不一致，先确认你看的到底是工作区、索引、当前分支，还是某个历史提交。
• 把 git show 和 git status、git log、git show 组合使用，通常比单独看一个输出更稳。