macOS下Git因元音变音编码差异持续误报文件变更问题

问题根源 #

Unicode文件名规范化格式不兼容：macOS的文件系统默认对带变音符号的Unicode文件名采用NFD（分解式规范化，即把ü拆分为普通u+组合变音符号）编码，而你克隆的仓库中存储的文件名是NFC（组合式规范化，即ü为单个Unicode字符）编码，Git默认不识别两种编码的语义等价性，会将其判定为两个不同的文件，从而出现你遇到的异常状态。

解决步骤 #

• 第一步：全局配置Git适配macOS文件名编码规则
  执行命令：

git config --global core.precomposeUnicode true

该配置会让Git自动将macOS系统返回的NFD格式文件名转换为NFC格式与仓库记录匹配，从根源避免同类问题。

• 第二步：备份当前的两个jpg文件到系统其他目录，避免数据丢失
• 第三步：清理当前仓库的异常状态，执行命令：

git reset --hard HEAD
rm Lebensstiltagebuch_Frühstück_*.jpg
git checkout HEAD -- .

• 第四步：执行git status确认无未提交变更后，即可正常执行git pull拉取远程最新内容。

协作注意事项 #

如果该仓库有其他使用macOS的协作者，建议同步配置上述core.precomposeUnicode参数，避免后续提交新的NFD格式文件名导致问题复现。

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