git-log 详解

2 min中级

git log多种格式与过滤选项：自定义输出、搜索过滤与可视化。

1. git log 基础

1.1 基本用法

git log                       # 查看完整日志
git log -5                    # 最近5条
git log --oneline             # 单行格式
git log --oneline -10         # 最近10条，单行格式

1.2 输出格式

# 默认格式
git log
# commit 9a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t
# Author: Zhang San <zhang@example.com>
# Date:   Sat Jun 14 10:00:00 2026 +0800
#
#     feat: add user authentication

# 单行格式
git log --oneline
# 9a1b2c3 feat: add user authentication

# 简短格式
git log --abbrev-commit

2. 自定义输出格式

2.1 预定义格式

# 单行
git log --oneline

# 紧凑
git log --oneline --graph --decorate

# 详细
git log --format=full

# 完整
git log --format=fuller

# 邮箱格式
git log --format=email

# 原始格式
git log --format=raw

2.2 自定义格式字符串

# 常用占位符
git log --format="%h - %an, %ar : %s"
# 9a1b2c3 - Zhang San, 2 hours ago : feat: add user auth

# 占位符参考
占位符说明示例
%H完整哈希9a1b2c3d4e5f...
%h短哈希9a1b2c3
%T完整 tree 哈希—
%t短 tree 哈希—
%an作者名Zhang San
%ae作者邮箱zhang@example.com
%ad作者日期—
%ar作者相对日期2 hours ago
%cn提交者名—
%s提交消息首行feat: add auth
%b提交消息正文—
%d引用装饰(HEAD -> main)
%f消息的文件名安全版本—

2.3 实用格式

# 美观的单行格式
git log --format="%C(yellow)%h%C(reset) %C(green)(%ar)%C(reset) %s %C(blue)<%an>%C(reset)"

# 图表格式
git log --oneline --graph --all --decorate

# 变更统计
git log --stat

# 每次提交的差异
git log -p

# 每次提交的差异（仅文件名）
git log --name-only

# 每次提交的差异（文件名+状态）
git log --name-status

3. 过滤选项

3.1 按数量

git log -5                    # 最近5条
git log -1                   # 最近1条

3.2 按日期

git log --since="2026-01-01"         # 2026年1月1日以来
git log --after="2026-01-01"         # 同上
git log --until="2026-06-14"         # 2026年6月14日之前
git log --before="2026-06-14"        # 同上
git log --since="2 weeks ago"        # 最近2周
git log --since="3 days ago"         # 最近3天
git log --after="yesterday"          # 昨天

3.3 按作者

git log --author="Zhang San"         # 按作者名
git log --author="zhang@example.com" # 按邮箱
git log --author="zhang"             # 模糊匹配

3.4 按提交消息

git log --grep="feat"                # 消息包含 "feat"
git log --grep="fix\|bug"            # 正则匹配
git log --grep="auth" -i             # 忽略大小写
git log --all-match --grep="feat" --grep="auth"  # 同时匹配

3.5 按文件

git log -- file.txt                  # 涉及指定文件的提交
git log -- src/                      # 涉及指定目录的提交
git log -p -- file.txt               # 显示文件差异
git log --follow file.txt            # 跟踪重命名

3.6 按引用范围

git log main..feature                # feature 有而 main 没有的提交
git log feature..main                # main 有而 feature 没有的提交
git log main...feature               # 两边独有的提交
git log --left-right main...feature  # 标注属于哪边

4. 图形化显示

4.1 内置图形

# ASCII 图形
git log --oneline --graph

# 带分支标签
git log --oneline --graph --decorate

# 所有分支
git log --oneline --graph --all

# 带日期和作者
git log --graph --format="%h %ad %an %s" --date=short

4.2 图形化工具

工具类型特点
gitk内置基础图形界面
tig终端终端中的交互式查看器
GitKraken桌面专业 Git 客户端
SourceTree桌面免费的 Atlassian 客户端
VS Code Git Graph插件VS Code 内集成

5. 实用别名

[alias]
    lg = log --oneline --graph --decorate
    lga = log --oneline --graph --all --decorate
    ll = log --format="%C(yellow)%h%C(reset) %s %C(cyan)(%cr)%C(reset) %C(blue)<%an>%C(reset)"
    ls = log --stat
    lp = log -p
    lf = log --follow
    recent = log --since='2 weeks ago' --oneline
    who = shortlog -sn

格式化输出

基本用法:简洁历史 git log --oneline

# 每个提交一行显示
git log --oneline

# 限制显示条数
git log --oneline -10

基本用法:图形化分支 git log --graph

# 图形化展示分支合并历史
git log --oneline --graph --all

# 带装饰标签
git log --oneline --graph --decorate

基本用法:自定义格式 git log --pretty=format:"<格式>"

# 自定义字段:哈希 作者 时间 说明
git log --pretty=format:"%h - %an, %ar : %s"

# 完整格式
git log --pretty=format:"%C(yellow)%h%Creset %C(green)%ad%Creset %s" --date=short

过滤条件

基本用法:按作者筛选 git log --author="<名称>"

# 按作者过滤
git log --author="zhangsan"

# 按提交说明搜索
git log --grep="fix"

基本用法:按时间筛选 git log --since=<时间>

# 最近 7 天
git log --since="7 days ago"

# 指定日期之后
git log --since="2026-01-01" --until="2026-06-30"

# 按相对时间
git log --since="2 weeks ago" --until="yesterday"

基本用法:按文件筛选 git log <路径>

# 查看某文件的提交历史
git log -- src/auth/login.js

# 显示每次提交改动的统计
git log --stat -- src/

# 显示每次提交的具体差异
git log -p -- package.json

范围与对比

基本用法:查看分支差异 git log <分支1>..<分支2>

# 查看 feature 比 main 多的提交
git log main..feature

# 查看两个分支各自独有的提交
git log --left-right main...feature

基本用法:查看指定行变更 git log -L <起始,结束>:<文件>

# 追踪文件中 10-20 行的变更历史
git log -L 10,20:src/utils.js

统计输出

基本用法:简明统计 git log --stat

# 显示文件改动统计
git log --stat

# 仅显示数字统计
git log --numstat

# 短统计格式
git log --shortstat