Git合并冲突HEAD与提交内容一致的成因及自动解决方法

执行git pull origin master拉取上游代码时，可能出现冲突标记两侧文本内容完全一致的异常冲突，示例如下：

<<<<<<< HEAD
gem 'fuzzy-string-match'
=======
gem 'fuzzy-string-match'
>>>>>>> 50147a3519be5bc883dabce86525ee4f36640b22

这类两侧内容肉眼完全一致的伪冲突，本质是Git判定两边提交存在差异，但差异属于不可见的元数据或格式差异，没有实际代码逻辑变更，常见诱因有以下几类：

• 换行符格式不统一：Windows系统默认使用CRLF（\r\n）作为换行符，Linux、macOS系统默认使用LF（\n）作为换行符。如果本地和上游提交的代码文本完全一致，但使用了不同的换行符格式，Git逐行对比时会判定为内容差异，最终生成的冲突块肉眼看不到区别。
• 文件权限位变更：Git会默认跟踪文件的可执行权限属性，普通文件权限标记为100644，可执行文件标记为100755。如果本地和上游对同一个文件的权限位做了不同修改，哪怕文件内容一字不差，也会触发冲突，冲突块内的文本内容自然完全相同。
• 不可见空白字符差异：比如行尾多余的空格、tab缩进和空格缩进混用、文件末尾空行数量差异，这类不可见的字符变化不会在普通文本预览中显示，但Git默认对比规则会将其判定为内容差异，最终生成无实际意义的冲突块。
• 文件重命名识别偏差：如果本地和上游都对同一个文件做了重命名、路径移动操作，当Git的重命名识别阈值未匹配到对应关系时，也可能抛出内容无差异的伪冲突。

根据冲突产生的不同原因，可以选择对应方案批量自动处理，不需要逐个人工核对：

• 处理换行符、空白字符类冲突：拉取合并时添加参数，让Git自动忽略无意义的空白、换行差异，执行命令：
  git pull -Xignore-all-space origin master
  如果仅需要忽略行尾的空白差异、保留代码中间的空格格式校验，可以将参数替换为-Xignore-space-at-eol。也可以提前配置Git的换行符自动转换规则避免后续同类问题：Windows环境执行git config --global core.autocrlf true，macOS/Linux环境执行git config --global core.autocrlf input，再重新执行拉取操作即可。
• 处理文件权限位类冲突：如果项目不需要跟踪文件的可执行权限变更，可以直接关闭Git的权限位校验功能，执行命令：
  git config --global core.fileMode false
  配置完成后重新执行合并，权限差异导致的伪冲突会被自动跳过。
• 批量处理已生成的伪冲突：如果冲突已经全部生成，可以让Git按照忽略空白的规则重新计算合并结果，执行：
  git merge -Xignore-all-space
  Git会自动识别所有忽略空白、换行差异后内容完全一致的冲突块，直接完成合并，不需要手动修改文件。处理完成后可以用git diff -w命令校验，该命令会忽略所有空白、换行类差异，如果输出为空就说明不存在实质内容冲突，直接提交合并结果即可。

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