←AI 实践笔记
Lesson 0010 · 约 7 分钟

合并信息
是一句有语法的话

上一课你注意到:teammate 的合并写着 Merge remote-tracking branch 'origin/…',你合到 test 时写的却是 Merge branch '…' into test。这不是风格差异——是 Git 按固定语法自动填的,每个词都在告诉你合并发生时的现场:站在哪个分支、合的是本地分支还是书签。

三个槽位

Git 自动生成的合并信息只有一个模板:

Merge  [槽① 合的是什么]  '[槽② 名字]'  [槽③ into 当前分支]
槽位
可能的值
读出什么
① 合的是什么
branch / remote-tracking branch
branch=本地分支;remote-tracking branch=书签 origin/x(0004 的中间那层)。后者说明操作者本机根本没有这个分支,fetch 之后直接合的书签。
② 名字
'origin/v2.2.2…' / 'feature/…'
带 origin/ 前缀的一定是书签。
③ into 当前分支
into test / 省略
操作者当时站在哪个分支。合进 master 时 Git 默认省略这一段——所以「没有 into」=「合进的是 master」。
into HEAD=当时没站在任何分支上(分离头指针,detached HEAD),只站在一个提交上。例:9-23 09:47 与 10:31 两次 Merge branch 'v2.2.5…' into HEAD,reflog 显示是在 review 工作树里检出 test 的某个提交后合的。之后要记得把结果推回 test,否则这个合并挂在空中、没有任何分支指着它。

省略规则来自 git-merge 手册的 merge.suppressDest:未配置时「默认使用 master」,合进匹配的分支时标题省略 into <branch-name>。(git-merge 手册 · merge.suppressDest)措辞模板本身见 git-fmt-merge-msg。

用仓库里真实的四句练

下面四句都来自 hdcloud-vcm 最近一个月的日志(前三种各有多少条:63 / 6 / 2)。每句拆成三个槽位,就能还原当时的现场。

原句
现场还原
Merge remote-tracking branch 'origin/v2.2.2订单导出与运营项目字段优化'
teammate · 9-14 · 出现 4 次
①书签 ②你的分支 ③省略→站在 master。他本机没有你的分支,git fetch 后直接 git merge origin/v2.2.2…。四次都是这句,说明四次都是「fetch 一下、书签挪了、再合一次」。
Merge branch 'feature/V2.2.4-esign-sdk3' into test
Ke Zhen · 9-14~9-15 · 出现 63 次(同类)
①本地分支 ②你的功能分支 ③站在 test。你在本机既有 feature 又有 test,从一个合到另一个。
Merge remote-tracking branch 'origin/master' into feature/V2.2.3来源单号与费率计费优化
Ke Zhen · 9-14
①书签 ②master 的书签 ③站在 feature 分支。方向反了:不是把功能合进主线,是把线上最新拉进自己的分支——为之后顺利合回 master 铺路(提前解冲突)。
merge: V2.2.3代码整理合入test
Ke Zhen · 9-16
不是 Git 写的,是人写的(小写、冒号、中文)。语法失效,三个槽位都读不出来——想知道合了什么只能点开看两个父亲。手写信息方便人读,代价是丢了机器可解析的现场。

第四种措辞你在 0009 见过:Merge branch 'x' into 'master',目标分支带引号——那是 GitLab 在 MR 页面上点合并时写的,不是 Git 本机生成的。本项目一句都没有,再次印证合并全在本机做。

「合书签」意味着什么

teammate 合的是 origin/v2.2.2… 这个书签,而书签是上次 fetch 时拍的照片(0004)。这带来两个后果,都在 0009 那张图上看得到:

后果一 · 合之前必须 fetch

origin/v2.2.2…

不 fetch 就合,合进去的是旧照片——你后来推的提交不在里面。所以他每次都是 fetch → merge → push 三连。

后果二 · 你推几次,他就得合几次

master

9-14 你推了 4 批,他合了 4 次,图上 4 个汇合点。每个汇合点=书签的一次新位置。如果你 4 批攒成 1 次推,就只有 1 个汇合点。

这也解释了你合到 test 为什么不用 fetch:你合的是本地分支 feature/…,它就在你电脑上,没有「照片过期」的问题——除非别人也往这个分支推了。

Retrieval Practice · 1 / 3

Merge remote-tracking branch 'origin/hotfix/x'——操作者站在哪、合的是什么?

Retrieval Practice · 2 / 3

Merge remote-tracking branch 'origin/master' into feature/V2.2.3…——这次合并之后,master 上多了东西吗?

Retrieval Practice · 3 / 3

teammate 合书签前若忘了 git fetch,结果是?

现在就做

  1. IDEA 的 Git 日志,文本框里输入 remote-tracking——列出来的全是「合书签」的合并。看看除了 teammate 还有谁这么合。
  2. 再输入 into test——这是所有合进 test 的记录。数一下最近一周有几条是你的。
  3. 下次你自己在 test 上合功能分支时,留意 IDEA 弹出的默认信息——现在你能一眼看出它三个槽位各填了什么。

接着读什么

主源推荐:Pro Git 中文版 · 3.5 远程分支——「合书签」这件事的全部底层就是这一节讲的远程跟踪分支,0004 引用过,现在带着「措辞」这个新线索再读一遍会不一样。

速查卡:提交图速查里新增了「合并信息三槽位」一节。下一课:Lesson 0011 · 变基把拐线拉直。

有任何不清楚的,直接问我。这一课没讲:git pull 生成的信息为什么长得像合书签(因为它就是 fetch + merge 书签);为什么有些团队禁止手写合并信息。