如何处理Git仓库混合CRLF与LF换行符导致的虚假变更问题

前置配置 #

• 先关闭当前仓库的autocrlf自动转换，避免和细粒度配置冲突：
  git config core.autocrlf false
  （如果需要全局适配所有同类场景，可加--global参数）
• 在仓库根目录创建.gitattributes文件，写入以下规则：

  # 自动识别文本文件：提交到仓库统一转LF，本地工作区自动转CRLF
  * text=auto eol=crlf
  # 二进制文件不做任何换行转换，避免损坏文件
  *.zip *.png *.exe *.pdf *.ico binary
  # 特殊文件需保留LF的可单独配置，示例：
  # *.sh text eol=lf
  

• 首次配置完成后执行一次全量归一化，提交初始化变更：
  git add --renormalize .
  这次提交会把仓库所有现有文件统一为标准换行格式，之后不会再出现冗余变更。

日常工作流 #

• 从外部导入LF格式的文件覆盖本地仓库文件后，执行：
  git add --renormalize <对应文件路径>
  Git会自动按照规则转换换行符，不会判定为无实际内容的虚假变更。
• 本地编辑文件正常保存即可，编辑器默认输出的CRLF无需手动调整，Git提交时会自动转成LF存入仓库。
• 如果撤销编辑后出现换行符变更提示，直接执行git restore <对应文件路径>即可恢复标准格式，无需手动修改换行符。

原配置失效原因说明 #

core.autocrlf属于仓库/全局级的粗粒度控制，仅在Git主动执行签出、提交操作时触发转换，无法识别外部手动覆盖导入的文件换行符差异，因此会产生虚假变更。.gitattributes的规则优先级更高，配合git add --renormalize可以主动对齐所有场景下的换行符规则，完全避免冗余的换行diff。

内容的提问来源于stack exchange，提问作者g.pickardou