新增.gitattributes后Git提示文件修改但diff无变更如何解决？

问题根源 #

这是Git行尾转换规则优先级变更后的正常表现，不属于隐藏Bug：

1. .gitattributes的行尾规则优先级高于全局core.autocrlf、core.eol配置，你新增该文件后，所有文本文件的行尾转换逻辑发生了变更
2. Git标记文件是否修改的依据是「按照当前规则计算的文件哈希值」和「暂存区记录的哈希值」是否匹配，规则变更后哈希校验不通过就会标记为modified
3. 执行diff操作时Git默认会对两端的行尾做归一化处理再对比内容，所以看不到实际差异

解决方案 #

按以下顺序执行即可完全消除异常：

• 第一步：先提交已编写完成的.gitattributes文件，确保规则被Git持久化记录

git add .gitattributes
git commit -m "add .gitattributes for standardized EOL rules"

• 第二步：执行行尾重归一化操作，让Git按照新规则重新计算所有文件的哈希值，刷新暂存区记录

git add --renormalize .

• 第三步：此时执行git status就能看到所有行尾需要调整的文件，直接提交这次归一化变更即可

git commit -m "normalize line endings per .gitattributes rules"

后续再执行git reset --hard或者切换分支，都不会再出现无意义的modified标记。

补充说明 #

如果不需要保留这次行尾归一化的提交记录，也可以在执行完git add --renormalize .后，执行git reset --hard HEAD清空暂存区和工作区的变更，此时Git的哈希缓存已经更新完成，也不会再出现假的修改标记。

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