git log 默认只显示当前分支的提交历史,需切换分支或指定分支名(如 git log main)才能查看其他分支记录;常用选项包括 --oneline、--graph --all --decorate 和 --stat 等。

git log 查看当前分支的提交历史
切换分支前,git log 只显示当前所在分支的提交记录。它默认从 HEAD 开始向上追溯,不跨分支展示——哪怕其他分支有更早或并行的提交,也不会出现在输出里。
常用实操建议:
- 加
--oneline让每条记录占一行,方便快速扫读:git log --oneline - 加
--graph --all --decorate可视化所有分支的拓扑关系(需先切换到目标分支再运行,否则仍只显示当前分支路径) - 如果想看某个文件的历史修改,用
git log -- path/to/file,它会过滤出修改过该文件的所有提交(仍在当前分支范围内)
git checkout 或 git switch 切换分支后再查 log
Git 不支持“不切换分支就直接查另一个分支的完整提交历史”。必须先让 HEAD 指向目标分支,git log 才能正确遍历它的提交链。
推荐用 git switch(Git 2.23+)替代老旧的 git checkout,语义更清晰:
- 切换已有分支:
git switch feature/login - 创建并切换新分支:
git switch -c bugfix/timeout - 切回上一个分支(类似 Alt+Tab):
git switch -
注意:git checkout branch-name 在 Git 2.23 后已进入“兼容模式”,但容易和文件恢复命令混淆,建议统一用 git switch。
不切换工作区也能查其他分支的提交记录
如果只是想快速浏览某分支的提交,不想改变当前工作目录状态(比如怕改错文件或未提交内容冲突),可以用带分支名的 git log:
-
git log main—— 查看 main 分支的提交,HEAD 不动 -
git log origin/develop—— 查看远程分支的提交(前提是已git fetch过) -
git log feature/a..feature/b—— 查看 b 有而 a 没有的提交(双点语法,常用于对比分支差异)
这类命令不会触发检出(checkout),也不会影响你的暂存区或工作区,适合快速诊断。
常见错误:git log 看不到刚合并进来的提交
典型现象是:在 main 上执行 git merge feature/x 后,git log 却没显示 feature/x 的提交。原因通常是 fast-forward 合并——Git 直接把 main 的指针移到了 feature/x 最后一个提交,没有产生 merge commit。
解决办法:
- 用
git log --all --oneline --graph确认是否真没合并成功(可能只是没push或漏fetch) - 强制生成 merge commit:
git merge --no-ff feature/x - 查某分支独有的提交:
git log main ^feature/x(注意空格和脱字符位置)
真正容易被忽略的是:log 默认不显示已被 GC 回收的“游离”提交,如果刚 reset 过又没打 tag,那些提交可能还在 reflog 里,得用 git reflog 找回来。











