Git diff检测文本文件开头异常字符 差异统计与WinMerge不符如何解决

使用Git与WinMerge开展文本文件差异对比时出现判定结果不一致：

• 两份文件实际仅存在1行有效内容修改，WinMerge可正确识别该单处变更
• 执行git diff命令时，程序检测到文件开头存在正常视图下不可见的特殊字符，最终判定存在2行变更，与实际修改情况不符
  初步判断该问题与文件编码差异相关，需通过Git配置屏蔽这类无意义的伪变更检测。

对比效果参考：

该异常的核心诱因是文件开头存在UTF-8 BOM（字节顺序标记）：这是Windows平台部分编辑器（如旧版系统记事本）保存UTF-8文件时，默认在文件头部追加的3字节不可见特殊标记。Git默认按原始字节逐位对比内容，不会自动过滤BOM带来的字节差异；WinMerge默认开启了BOM差异忽略规则，因此二者的变更判定结果不一致。

按以下优先级配置即可解决问题，从根源避免编码类伪变更：

• 全局配置Git自动识别处理BOM（推荐，一次配置全仓库生效）
  1. 执行命令配置Git全局属性文件路径：

  git config --global core.attributesfile ~/.gitattributes
  

  2. 打开当前用户根目录下的.gitattributes文件（不存在则手动新建），写入以下规则：

  * text=auto eol=lf
  *.txt working-tree-encoding=UTF-8
  

  配置完成后，Git对比文本文件时会自动识别UTF-8 BOM，不会将其判定为内容变更。
• 统一全链路文件编码规范
  要求所有文本文件保存时使用无BOM的UTF-8编码，从源头杜绝BOM字符混入：
  • 代码编辑器（如VS Code）：在编码设置中将默认保存格式设为无BOM的UTF-8
  • Windows记事本：Win10 1903及以上版本默认保存为无BOM UTF-8，旧版本保存时注意不要选择带BOM的UTF-8选项
  • WinMerge：在「编辑-选项-编码」菜单中，将默认打开、保存编码统一设置为无BOM UTF-8，与Git规则保持对齐
• 配置Git忽略空白类伪差异
  如果还存在其他不可见空白字符（如行尾空格、制表符/空格混用）导致的伪变更，可以执行以下命令，让Git对比时默认忽略行首尾的无意义空白差异：

  git config --global diff.ignoreSpaceAtEol true
  

  该配置仅过滤空白类差异，不会影响正文有效内容的变更判定。

配置完成后回到目标仓库重新执行git diff，原本由开头不可见字符导致的多余变更行会消失，仅显示实际修改的1行有效内容，与WinMerge的判定结果保持一致。

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