如何避免将线性提交从一个分支变基到另一分支时的冲突？

问题场景回顾 #

你的分支流程是：

1. 从master（提交X）拉出feature/1，完成提交A
2. 基于feature/1拉出feature/2，完成提交B
3. feature/1合并到master后生成合并提交M，此时master提交链为X -> A -> M
4. 将feature/2变基到master时，出现大量无意义冲突（包括换行符变更、重复代码被标记冲突）

分支结构图示：

# 合并前
master    ---- X
                \
feature/1        A
                  \
feature/2          B

# 合并后
master    ---- X - A - M
feature/1 ---- X - A
                    \
feature/2            B

你执行的命令流程：

• git checkout master && git pull
• git checkout -b feature/1，开发提交后推送
• git checkout -b feature/2，开发提交后推送
• 等feature/1合并到master后，再次拉取master，切换到feature/2执行git rebase master触发冲突

冲突原因分析 #

结合你的Git配置和操作流程，冲突主要来自这几个方面：

1. 换行符配置缺失：你的全局Git配置未设置core.autocrlf，MacOS默认用LF换行符，但如果仓库存在CRLF格式文件或远程仓库换行符不一致，变基时Git会把换行符差异识别为代码冲突。GitKraken默认处理换行符自动转换，因此同事未遇到该问题。
2. 变基策略未精准指定：直接使用git rebase master时，Git会尝试将feature/2的所有提交（包括已合并到master的A）重新应用到master上，合并提交M的存在可能导致Git冲突检测逻辑误判，引发重复对比。
3. Git版本较老：你使用的Git 2.30.0是2021年发布的版本，该版本在变基冲突检测、合并逻辑上存在已知问题，后续版本已修复不少类似无意义冲突场景。

解决方法 #

1. 配置换行符自动处理 #

在终端执行以下命令，设置适配MacOS的换行符转换规则：

git config --global core.autocrlf input
git config --global core.safecrlf true

• core.autocrlf=input：提交代码时自动将CRLF转换为LF，检出时不做转换，适配Unix/Linux/Mac环境，避免换行符差异引发冲突。
• core.safecrlf=true：当转换会导致文件内容变更时，Git会报错提醒，防止意外修改。

2. 使用精准的变基命令 #

跳过已合并到master的feature/1提交，仅将feature/2独有的提交（B）变基到master上：

git checkout feature/2
git rebase --onto master feature/1

该命令的作用是：将feature/2中位于feature/1之后的所有提交（即你的提交B）重新应用到master的最新提交上，完全避开已合并的提交A，从根源减少冲突概率。

3. 更新Git到最新稳定版 #

用Homebrew更新Mac上的Git：

brew update
brew upgrade git

新版本Git优化了冲突检测算法，能更准确识别已合并提交，减少无意义冲突。

4. 重置feature/2的跟踪分支 #

如果后续需持续基于master开发，可将feature/2的上游分支切换为master：

git checkout feature/2
git branch -u master

验证步骤 #

1. 执行完上述配置后，拉取最新master代码：

   git checkout master && git pull
   

2. 重新执行精准变基命令：

   git checkout feature/2
   git rebase --onto master feature/1
   

3. 若仍有冲突，检查冲突文件的换行符：

   file path/to/conflicted-file
   

   如果显示CRLF line terminators，可用dos2unix命令转换为LF：

   dos2unix path/to/conflicted-file
   

   之后继续完成变基流程即可。

内容的提问来源于stack exchange，提问作者Matt Kellner