←AI 实践笔记
Lesson 0009 · 约 9 分钟

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订单导出与运营项目字段优化 分支。

105b652eMerge remote-tracking branch 'origin/v2.2.2订单导出…'origin & masterteammate
f04c456refactor(v2.2.2): 精简——导出列块抽 <sql> 片段共用…origin & v2.2.2…Ke Zhen
4fc5a82refactor(cargo): 项目人员手机号去掉 IGNORED 策略…Ke Zhen
24361a8dMerge remote-tracking branch 'origin/v2.2.2订单导出…'teammate
a7e42c2fix(v2.2.2): 审核回改——项目人员快照改落 vcm_order_detail…Ke Zhen
f5e4a8aMerge remote-tracking branch 'origin/v2.2.2订单导出…'teammate
5a196a1导出货物类型改为 Java 层批量组装…Ke Zhen
8e3ebd8Merge remote-tracking branch 'origin/v2.2.2订单导出…'teammate
39a9fa2v2.2.2 DDL 排序规则改为 utf8mb4_general_ciKe Zhen
ec5320ev2.2.2 DDL 改为符合 Archery 审核规则…Ke Zhen
b8628aa后台订单导出司机姓名/电话改取订单指派司机…Ke Zhen
e5e9e5a承运商预估运费列仅在订单已指派承运商时输出Ke Zhen
3a0414afv2.2.2 订单导出新增字段 & 运营项目人员维护Ke Zhen
421ff990预估运费必填校验只在合约运力分支生效origin & fix-修复运费…Ke Zhen
3fbbdd7合同未签署报错补充运营主体…Ke Zhen
9846893恢复中台鼎流优车待接单阶段货主运费填写及修改Ke Zhen
2628745移除本地运费回归脚本Ke Zhen
4704943修复中台应收与平台应付串改并补全运费操作记录Ke Zhen
e04c365修复鼎流优车货主应付同步、完成状态及承运运费展示Ke Zhen
b664600Merge remote-tracking branch 'origin/feature/平安保险传参优化'teammate
  1. 最上面的空心点是「汇合」。它下面伸出两条线:蓝线接着往下走(上一个 master),琥珀线拐到右边接 f04c456(分支最新提交)。这就是 teammate 把你的分支合进 master 的那一下。「Merge remote-tracking branch」这句话,Git 会自动写,意思正是「我把 origin/某分支 合进来了」。
  2. 同一条分支被合了四次。四个空心点,四条琥珀线拐进去。为什么?因为你每推一次新提交,他就再合一次——每次合并只带进上次合并之后新出现的那几个点。比如 4361a8d 这次只带进了 a7e42c2 一个提交,因为 5a196a1 已经在上一次(f5e4a8a)合过了。
  3. 琥珀线的起点是「分叉」。顺着琥珀线一直往下,它在最底下的 b664600 拐回蓝线。意思是:v2.2.2 分支是 9 月 10 日从那时候的 master 拉出来的,从那以后 master 和它各走各的。
  4. 「fix-修复运费同步」分支的 6 个提交没有汇合点。它们直接排在蓝线上,标签就贴在 21ff990。这就是 Pro Git 说的快进:合并时 master 自那以后一步没动,「Git 在合并两者的时候,只会简单地将指针向前推进」,不产生合并提交。(Pro Git 中文版 · 3.2 分支的新建与合并)所以图上看不出它「曾经是个分支」——这也是为什么同一天的两个分支,一个画成拐线、一个画成直线。

第 4 点展开:快进到底做了什么。只用一条规则——合并=让 master 标签「包含」另一个分支。做法取决于合并那一刻 master 动没动过。

fixv2.2.2 ← master

① 合并前

两个分支都从 b664600 拉出。master 标签还贴在 b664600。

fixv2.2.2 ← master

② 先合 fix:快进

fix 的线往下走不拐弯就到 b664600,master 没动过。Git 只把 master 标签撕下来贴到 21ff990。没造新点,所以是直线。

← master v2.2.2

③ 再合 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 服务器自己的。

第一本 · Git 提交
第二本 · GitLab 推送事件
谁记
Git
GitLab 服务器
记什么
谁写了这段代码、几点写的、父亲是谁
谁推了哪个分支、几点、从哪个 hash 到哪个 hash
存在哪
仓库里,每台电脑都有一份,IDEA 日志画的就是它
只在 GitLab 数据库里,IDEA 永远看不到
为什么知道是谁
提交时本机配置的 user.name,自己填的
推送必须登录,服务器看凭证(SSH key / 账号)
fix 那次
6 个提交作者全是 Ke Zhen,日期 9 月 10 日
teammate,9 月 14 日 10:26:20,master 从 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 只是给每条并行的线分配一个颜色好区分,同一个分支翻一页可能就换色了。看形状,别看颜色。

Retrieval Practice · 1 / 3

05b652e 这个点下面伸出两条线,说明它是?

Retrieval Practice · 2 / 3

「fix-修复运费同步」的 6 个提交直接排在 master 那条线上,没有汇合点。原因是?

Retrieval Practice · 3 / 3

4361a8d 这次合并,新带进 master 的分支提交有几个?

第二个真实例子:你 v2.2.5 分支上的「梯子」

9 月 23 日你在 IDEA 里看到一段锯齿状的线(test 分支,截最近 10 个点)。拓扑是这样的:

3300bceMerge branch 'fix/订单导出货物类型改由主SQL子查询取列' into test16:52
7e218dbfix(export): 货物类型字典查不到的 key 也缓存…16:48
5b5acbdMerge branch 'v2.2.5鼎流优车合约运力一键完结' into test15:55
c537db9perf(v2.2.5): 批量异常完结限 50 单…你的 HEAD15:55
58890cdMerge branch 'v2.2.5…' into test15:19
2ed3b44chore(v2.2.5): 异常完结时间字段改 NOT NULL…15:19
e0bb595Merge branch 'v2.2.5…' into test15:17
dcb7504fix(v2.2.5): 开启发运至上传回单不允许取消…15:17
540a8b9Merge branch 'v2.2.5…' into test15:05
629f4b3chore(v2.2.5): 原承运商费用快照字段改 NOT NULL…15:05

蓝=test,琥珀=v2.2.5,绿=fix 分支。IDEA 画成锯齿、互相交叉,只是它的布局选择;拓扑就是一架梯子。

  1. 梯子=同一个分支,每提交一次就合一次。琥珀色是竖杆(v2.2.5 自己的提交一个接一个),每一根从 test 拐过去的线是一根横档(一次合并)。这一天你合了 11 次:9 次 into test,2 次 into HEAD(后者见 0010 槽③)。每根横档只带进 1 个提交——和上面 v2.2.2 被合 4 次是同一回事,只是更密。
  2. 为什么一次都没快进?套 0009 的判据:合并那一刻,test 自分叉后动过没有?第一次合并造了汇合点之后,test 上就多了一个 v2.2.5 没有的点(那个汇合点本身)。你再往 v2.2.5 提交,新提交的父亲是 v2.2.5 上一个点,不是那个汇合点——所以下一次又分叉了,又得造新点。梯子一旦开始,每一格都是真合并,自己停不下来。
  3. 纵穿全场的绿线是 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)
  4. 紫色空心点是 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鼎流优车合约运力一键完结
Retrieval Practice · 梯子

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 只看主线。想知道哪个,说一声。