使用git status命令时分支名称大小写显示错误的原因排查

原因 #

这是Mac系统默认APFS文件系统的特性导致的：大小写不敏感但保留大小写。具体细节如下：

• 执行git branch SoftPhoneWidget创建分支时，Git会在.git/refs/heads/目录下生成名称为SoftPhoneWidget的文件，严格保留你输入的大小写格式。
• 但Mac的APFS不区分文件名的大小写，当Git读取当前分支信息时，可能因文件系统的路径解析或缓存机制，返回了小写P的分支名（SoftphoneWidget）。
• 而git branch -r读取的是远程BitBucket仓库的分支名，远程仓库的文件系统是大小写敏感的，因此能正确显示大写P的分支名。

解决办法 #

• 刷新本地缓存：切换到其他分支再切回目标分支，触发Git更新分支名缓存：

  git checkout main
  git checkout SoftPhoneWidget
  

• 强制Git区分大小写：修改Git配置，让其忽略文件系统的大小写不敏感特性：

  git config core.ignorecase false
  

  注意：开启前需确保本地没有大小写冲突的分支（如同时存在SoftPhoneWidget和SoftphoneWidget），否则会引发文件冲突。
• 重命名分支强制刷新：如果上述方法无效，通过重命名分支来重置本地分支名记录：

  git checkout SoftPhoneWidget
  git branch -m SoftPhoneWidget-temp
  git branch -m SoftPhoneWidget
  

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