git log 用来查提交历史。默认输出偏长,但加上参数后可以变成一行一条的清单、带分支拓扑的图、按人或按时间筛过的报表,甚至直接搜出「哪次提交引进了某个字符串」。
本文把 git log 的常用参数按用途分组列出并解说,最后给一组可以直接存成别名的组合。
关于本系列
本文是《Git 使用教程》按命令拆分的第 8 / 28 篇,全部收录在 Git 栏目。参数表列的是日常高频项,并非穷举;想看某个命令的完整参数,用
git log -h 看精简列表、git help log 看完整手册。示例以 Git 2.56.0 为准。一、命令语法
先看语法骨架,再对照下一节的参数表。<占位> 表示必填值,实际输入时不要带尖括号;[...] 表示可选项,-- 用来分隔选项与路径。
bash语法
git log [<options>] [<revision-range>] [[--] <path>...]
二、参数逐项详解
下表按用途列出 git log 的常用参数,每项都注明了「它到底改变了什么」。
| 参数 | 作用 |
|---|---|
--oneline | 每条提交压成一行:短哈希 + 标题 |
--graph | 用 ASCII 线画出分支与合并的拓扑 |
--decorate[=<模式>] | 标出 HEAD、分支名、标签名;short / full / auto / no |
--all | 显示所有 refs 的历史,不只是当前分支 |
-<n> / --max-count=<n> | 只看最近 n 条,如 git log -5 |
--author=<串> / --committer=<串> | 按作者 / 提交者过滤,支持正则 |
--since / --until | 按时间过滤,如 --since="2 weeks ago" |
--grep=<串> | 按提交信息过滤;--all-match 要求多个条件同时满足 |
--stat / --shortstat | 附文件改动统计 / 只要一行汇总 |
-p / --patch | 把每条提交的完整 diff 也打出来 |
--pretty=<格式> / --format=<格式> | 自定义输出字段,如 %h %ad %an %s |
--abbrev-commit | 只显示短哈希(配合 --oneline 默认开启) |
--name-only / --name-status | 列出改动文件名 / 文件名加状态字母 |
--no-merges / --merges | 排除 / 只看合并提交 |
--first-parent | 只沿第一个父提交走,看主干历史时非常干净 |
--follow | 跟踪单个文件跨重命名的历史 |
-S<串> / -G<正则> | pickaxe 搜索:找「某字符串被引进/删除」或「匹配行发生变化」的提交 |
--reverse | 逆序输出,最老的在前 |
-- <路径> | 只显示影响该路径的提交 |
三、常用示例
每天都在用的组合
bash每天都在用的组合
git log --oneline --graph --decorate --all -20
git log --oneline --no-merges --first-parent main
git log --author="zhangsan" --since="2026-01-01" --oneline
定位问题从哪次提交开始
bash定位问题从哪次提交开始
git log -S"deprecatedApi" --oneline -- src/
git log --follow --oneline -- src/legacy.js
git log --pretty=format:"%h %ad %an %s" --date=short -10
存成别名
bash存成别名
git config --global alias.lg "log --oneline --graph --decorate --all"
git config --global alias.last "log -1 --stat"
git lg
四、注意事项
查「谁把这个函数删了」用 -S:
git log -S"函数名" --oneline 会找出该字符串出现次数发生变化的所有提交,比按提交信息搜 --grep 准得多。分支多时先想清楚范围
不加
--all 只能看到当前分支可达的提交;想看别人分支的进展,要先 git fetch --prune 再 git log --all。浅克隆仓库里历史本身就不完整,需要 git fetch --unshallow。五、小结
git log 的参数可以按三句话归类:看多少(-n、--all、--first-parent)、筛哪些(--author、--since、--grep、-S)、显示成什么样(--oneline、--graph、--stat、--pretty)。组合起来就是自己的查询语言。
本系列共 28 篇,一个命令一篇,完整目录见 Git 栏目。下一篇:git show 命令参数详解。