Git 日志里
那条线是什么
你今天在 IDEA 的 Git 日志左边看到一列彩色的点和线。它只表达一件事:每个提交记着「我的父亲是谁」。点是提交,线是父子关系。看懂这条线,就能回答发版时最常问的两个问题——「我的改动进 master 了吗」「这次合并到底带进了什么」。
一个点,一条线
Pro Git 的定义只有一句:Git 的每个提交对象都指向它的父提交——「普通提交操作产生的提交对象有一个父对象,而由多个分支合并产生的提交对象有多个父对象」。(Pro Git 中文版 · 3.1 分支简介)
IDEA 那一列,就是把这句话画出来:每个点往下画一条线,连到它的父亲。日志是新的在上、旧的在下,所以线永远是从上面的点指向下面的点。分支只是一个贴在某个点上的标签(截图里的 origin & master),「本质上仅仅是指向提交对象的可变指针」——这和 Lesson 0004 讲的书签是同一回事。
于是整张图只会出现三种形状:
分叉
一个点上面长出两条线。两个提交有同一个父亲:有人从这里拉了分支,两边各自往前走。
汇合
一个点下面伸出两条线。这个点是合并提交,有两个父亲。它的信息通常就叫 Merge …。
直线
没有分叉也没有汇合。要么一直只有一个人在改,要么是分支被快进合并了——下面用你自己的提交解释。
读你今天截图里那 20 个点
下面是 hdcloud-vcm 的 master 最近 20 个提交,和你截图里的顺序一模一样(git log --graph master -20 画出来的就是它)。蓝色是 master 那条线,琥珀色是 v2.2.2订单导出与运营项目字段优化 分支。
05b652eMerge remote-tracking branch 'origin/v2.2.2订单导出…'origin & masterteammatef04c456refactor(v2.2.2): 精简——导出列块抽 <sql> 片段共用…origin & v2.2.2…Ke Zhen4fc5a82refactor(cargo): 项目人员手机号去掉 IGNORED 策略…Ke Zhen4361a8dMerge remote-tracking branch 'origin/v2.2.2订单导出…'teammatea7e42c2fix(v2.2.2): 审核回改——项目人员快照改落 vcm_order_detail…Ke Zhenf5e4a8aMerge remote-tracking branch 'origin/v2.2.2订单导出…'teammate5a196a1导出货物类型改为 Java 层批量组装…Ke Zhen8e3ebd8Merge remote-tracking branch 'origin/v2.2.2订单导出…'teammate39a9fa2v2.2.2 DDL 排序规则改为 utf8mb4_general_ciKe Zhenec5320ev2.2.2 DDL 改为符合 Archery 审核规则…Ke Zhenb8628aa后台订单导出司机姓名/电话改取订单指派司机…Ke Zhene5e9e5a承运商预估运费列仅在订单已指派承运商时输出Ke Zhena0414afv2.2.2 订单导出新增字段 & 运营项目人员维护Ke Zhen21ff990预估运费必填校验只在合约运力分支生效origin & fix-修复运费…Ke Zhen3fbbdd7合同未签署报错补充运营主体…Ke Zhen9846893恢复中台鼎流优车待接单阶段货主运费填写及修改Ke Zhen2628745移除本地运费回归脚本Ke Zhen4704943修复中台应收与平台应付串改并补全运费操作记录Ke Zhene04c365修复鼎流优车货主应付同步、完成状态及承运运费展示Ke Zhenb664600Merge remote-tracking branch 'origin/feature/平安保险传参优化'teammate- 最上面的空心点是「汇合」。它下面伸出两条线:蓝线接着往下走(上一个 master),琥珀线拐到右边接
f04c456(分支最新提交)。这就是 teammate 把你的分支合进 master 的那一下。「Merge remote-tracking branch」这句话,Git 会自动写,意思正是「我把origin/某分支合进来了」。 - 同一条分支被合了四次。四个空心点,四条琥珀线拐进去。为什么?因为你每推一次新提交,他就再合一次——每次合并只带进上次合并之后新出现的那几个点。比如
4361a8d这次只带进了a7e42c2一个提交,因为5a196a1已经在上一次(f5e4a8a)合过了。 - 琥珀线的起点是「分叉」。顺着琥珀线一直往下,它在最底下的
b664600拐回蓝线。意思是:v2.2.2分支是 9 月 10 日从那时候的 master 拉出来的,从那以后 master 和它各走各的。 - 「fix-修复运费同步」分支的 6 个提交没有汇合点。它们直接排在蓝线上,标签就贴在
21ff990。这就是 Pro Git 说的快进:合并时 master 自那以后一步没动,「Git 在合并两者的时候,只会简单地将指针向前推进」,不产生合并提交。(Pro Git 中文版 · 3.2 分支的新建与合并)所以图上看不出它「曾经是个分支」——这也是为什么同一天的两个分支,一个画成拐线、一个画成直线。
第 4 点展开:快进到底做了什么。只用一条规则——合并=让 master 标签「包含」另一个分支。做法取决于合并那一刻 master 动没动过。
① 合并前
两个分支都从 b664600 拉出。master 标签还贴在 b664600。
② 先合 fix:快进
fix 的线往下走不拐弯就到 b664600,master 没动过。Git 只把 master 标签撕下来贴到 21ff990。没造新点,所以是直线。
③ 再合 v2.2.2:造新点
master 已在 21ff990,v2.2.2 的线走不到它——分叉了。光挪标签会丢一边,必须造一个两个父亲的新提交 8e3ebd8。这就是空心汇合点。
形状取决于合并顺序,不取决于分支本身。要是那天先合 v2.2.2、后合 fix,图会反过来:v2.2.2 是直线,fix 是拐线。判断只问一句:合并那一刻,master 自分叉后动过没有?没动→挪标签,直线;动了→造新点,汇合。
追问:为什么看不到「谁把 fix 合进 master」?
你期待的记录长这样:「teammate · 9 月 14 日 · Merge branch 'fix-…' into master」。这一行在 Git 里叫合并提交——它不是 Git 自动记的日志,它本身就是一个提交,必须有人造出来才存在。快进没造它,所以不是记录被删了或藏了,是从来没被创建过。GitLab 分支页上的「已合并」标签也不是记录,是现算的:21ff990 是 master 的祖先 → 贴标,它同样不知道谁合的、几点合的。
两本账
「谁写的」和「谁推的」是两件事、两个人、记在两个地方。Git 只有第一本;第二本是 GitLab 服务器自己的。
user.name,自己填的b664600 推到 21ff990,6 个提交第一本账原文:git cat-file -p 21ff99093
tree 306f1d3…
parent 3fbbdd7…
author Ke Zhen 1789033581 +0800
有:父亲、作者、写它那一刻的时间。没有:「我在哪个分支」「我何时进 master」「谁合的我」。而且写好就不能改——改一个字 hash 就变了。
第二本账原文:GitLab events 接口
"author": {"username": "teammate"},
"created_at": "2026-09-14T10:26:20",
"push_data": {
"ref": "master",
"commit_from": "b6646007…",
"commit_to": "21ff9909…",
"commit_count": 6 }
快进的第二个坑:连合并日期也丢。第一本账里 fix 的 6 个点全写着 9 月 10 日,但第二本账说它们 9 月 14 日才进 master——在分支上躺了 4 天。有人问「运费同步那个修复上线没」,光看提交日期会答错。有汇合点的合并自带时间戳(v2.2.2 那四次:10:27 / 10:42 / 11:06 / 14:13);快进的时间只在第二本账里。
合并提交的措辞也能告诉你合并发生在哪:Merge remote-tracking branch 'origin/x' 是本机敲 git merge 生成的;GitLab 上点 MR 合并写的是 Merge branch 'x' into 'master'。本项目是前者,所以 MR 列表里也没有账(侧栏「合并请求 0」)。
查第二本账:活动页所有人事件混排、翻起来费劲,直接开接口(浏览器已登录即可,改日期),页内搜 "ref":"master":https://git.example.com/api/v4/projects/vcm%2Fhdcloud-vcm/events?action=pushed&after=2026-09-09&before=2026-09-15&per_page=100
想以后每次合并第一本账里都有那一行:合并时加 --no-ff(即使能快进也硬造合并提交),或在 GitLab 项目设置把 Merge method 设为 Merge commit 并改走 MR。这是团队规范,不是 Git 出错。(git-merge 手册 · --no-ff)
颜色不代表任何固定含义。IDEA 只是给每条并行的线分配一个颜色好区分,同一个分支翻一页可能就换色了。看形状,别看颜色。
05b652e 这个点下面伸出两条线,说明它是?
「fix-修复运费同步」的 6 个提交直接排在 master 那条线上,没有汇合点。原因是?
4361a8d 这次合并,新带进 master 的分支提交有几个?
第二个真实例子:你 v2.2.5 分支上的「梯子」
9 月 23 日你在 IDEA 里看到一段锯齿状的线(test 分支,截最近 10 个点)。拓扑是这样的:
3300bceMerge branch 'fix/订单导出货物类型改由主SQL子查询取列' into test16:527e218dbfix(export): 货物类型字典查不到的 key 也缓存…16:485b5acbdMerge branch 'v2.2.5鼎流优车合约运力一键完结' into test15:55c537db9perf(v2.2.5): 批量异常完结限 50 单…你的 HEAD15:5558890cdMerge branch 'v2.2.5…' into test15:192ed3b44chore(v2.2.5): 异常完结时间字段改 NOT NULL…15:19e0bb595Merge branch 'v2.2.5…' into test15:17dcb7504fix(v2.2.5): 开启发运至上传回单不允许取消…15:17540a8b9Merge branch 'v2.2.5…' into test15:05629f4b3chore(v2.2.5): 原承运商费用快照字段改 NOT NULL…15:05蓝=test,琥珀=v2.2.5,绿=fix 分支。IDEA 画成锯齿、互相交叉,只是它的布局选择;拓扑就是一架梯子。
- 梯子=同一个分支,每提交一次就合一次。琥珀色是竖杆(v2.2.5 自己的提交一个接一个),每一根从 test 拐过去的线是一根横档(一次合并)。这一天你合了 11 次:9 次
into test,2 次into HEAD(后者见 0010 槽③)。每根横档只带进 1 个提交——和上面 v2.2.2 被合 4 次是同一回事,只是更密。 - 为什么一次都没快进?套 0009 的判据:合并那一刻,test 自分叉后动过没有?第一次合并造了汇合点之后,test 上就多了一个 v2.2.5 没有的点(那个汇合点本身)。你再往 v2.2.5 提交,新提交的父亲是 v2.2.5 上一个点,不是那个汇合点——所以下一次又分叉了,又得造新点。梯子一旦开始,每一格都是真合并,自己停不下来。
- 纵穿全场的绿线是
fix/订单导出货物类型…。它 9 月 21 日从e710329拉出来,只有 1 个提交,今天 16:52 才合进 test。父子关系要从 9-21 连到今天,所以这条线一路穿过 v2.2.5 整段。线长不代表改动多,只代表分叉得早、合得晚。IDEA 默认把这种长线折成一个向下的箭头,JetBrains 文档原话是长分支「are replaced with a down arrow」,可在日志设置里开 Show Long Edges 显示全线。(JetBrains · Log tab) - 紫色空心点是
c537db9,正是你hdcloud-vcm-v225工作树当前检出的位置,可以当成「你在这里」。JetBrains 文档没写这个圆圈的含义,这一条是按位置对上的,不是官方定义。
这张图对发版有什么用:梯子在 test 上是正常的——test 是提测用的集成分支,合得密是为了让测试随时拿到最新。但它有两个副作用:
① 看 v2.2.5 改了什么,别在 test 上看,横档会把视线切碎。IDEA 左侧只勾 v2.2.5… 这一个分支,就只剩一根直竖杆。
② 提测前确认 test 没漏合,一条命令就够,输出为空=v2.2.5 的提交全都进了 test:
git log --oneline origin/test..origin/v2.2.5鼎流优车合约运力一键完结
v2.2.5 每次合进 test 都造了汇合点,一次都没快进。原因是?
发版前用它回答两个问题
看图是为了判断,不是为了欣赏。下面两句是发版路径上真正会用到的,图和命令各给一个,答案互相印证。
「我的提交进 master 了吗?」
看图:从你的提交往上找,能不能沿着线走到贴着 origin & master 标签的那个点。走得到=进了。
命令:
git branch -r --contains f04c45672
列出来的远端分支里有 origin/master,就是进了。这条比看图更硬,图上翻不到的老提交也能查。
「这次合并带进了什么?」
看图:从汇合点拐出去的那条线,数到下一个汇合点之前经过的点。
命令:
git log --oneline 4361a8dbd^1..4361a8dbd^2
^1 是第一个父亲(上一个 master),^2 是第二个父亲(分支那头)。「在第二个父亲里、但不在第一个父亲里」的提交,就是这次带进来的。
现在就在 IDEA 里做一次:点开 05b652e 那个合并提交,右侧文件列表就是这次合并实际改到 master 的文件——和上面命令数出来的提交对一下,改的东西是否对得上。
接着读什么
主源推荐:Pro Git 中文版 · 3.1 分支简介(一手,中文,配图)。这一节的几张图和 IDEA 那列线是一回事,只是横着画。读到「分支创建」那张图为止就够。
IDEA 那个面板本身的说明:JetBrains 官方 · Log tab——分支标签的颜色含义、按分支 / 用户 / 日期筛选。
速查卡:提交图三形状与两个发版问题。
有任何不清楚的,直接问我。这一课刻意没讲的有:为什么 teammate 每次合并都是「Merge remote-tracking branch」而不是本地分支名(和 0004 的三层模型有关);rebase 为什么会把拐线「拉直」;--first-parent 只看主线。想知道哪个,说一声。