Git创建推送分支时大小写不匹配报错,如何保留小写bugfix/前缀正常推送?
小写bugfix前缀分支推送报错解决方案
问题核心成因
这类大小写分支可用、全小写分支触发fatal: 分支无法解析报错的本质,是本地/远程仓库的存储介质为大小写不敏感的文件系统(常见于Windows默认NTFS配置、macOS默认APFS配置),叠加Git本地引用缓存冲突导致:
- 仓库历史中曾存在过同路径但首字母大写的分支引用(比如历史上建过
Bugfix/xxx、Feature/xxx的分支),Git在解析全小写的bugfix/xxx分支路径时,会错误匹配到已有的大小写不一致的旧引用,触发解析失败。 - 这类报错的提示文本经常和实际冲突的分支名不匹配,哪怕提示的是无关的
Feature/Name无法解析,本质都是引用层的大小写冲突。
可落地解决步骤
- 第一步:清理本地Git存储的远程分支引用缓存,修正大小写不匹配的错误引用项,依次执行命令:
git fetch origin --prune git remote prune origin - 第二步:排查本地是否存在残留的大小写冲突分支,执行命令拉取全量分支列表:
如果列表中存在首字母大写的git branch -aBugfix/、Feature/开头的残留本地分支,直接强制删除对应分支:git branch -D 冲突分支的完整名称 - 第三步:确认无残留冲突后,重新创建全小写前缀的目标分支:
git checkout -b bugfix/bug-21 - 第四步:推送分支到远程时,手动明确映射推送的源分支和目标分支名,绕开Git自动大小写匹配的逻辑:
git push origin bugfix/bug-21:bugfix/bug-21
长期规避方案
- 执行Git配置命令,强制本地Git对路径大小写做敏感匹配,避免后续出现同类引用冲突:
git config core.ignorecase false - 如果执行完以上步骤仍报错,需检查远程仓库的分支列表,确认是否存在远程端残留的大小写不匹配旧分支(比如远程已存在
Bugfix/bug-21的同路径分支),需联系仓库管理员删除该旧分支后再重新推送全小写前缀的分支。
内容的提问来源于stack exchange,提问作者NoobTechie
相关产品推荐
相关产品推荐

