Git Push 失败：分支名大小写不一致问题解析

问题现象

你可能遇到过这样的情况：git pull 工作正常，但 git push 却直接报错：

git push origin HEAD:feature/S1
# fatal: The upstream branch of your current branch does not match...

而你的本地分支明明是 feature/sp1（小写 s），错误信息却提示 feature/S1（大写 SP）。

根本原因

这是 Git 分支名大小写敏感导致的典型问题：

• 本地分支 ：feature/s1（小写 s）
• 远程分支 ：origin/feature/S1（大写 S）

当执行 git push 时，Git 默认使用 push.default = simple 模式（Git 2.0+ 的默认配置）。该模式要求：

• 本地分支必须设置 upstream（跟踪分支）
• 本地分支名与 upstream 分支名完全一致（包括大小写）

大小写不匹配时，Git 会拒绝推送以避免潜在错误。

为什么 pull 没问题？

git pull 的检查机制更宽松，只要存在 upstream 就能执行，不强制要求分支名大小写完全一致。

解决方案

重命名分支名

# 1. 确认远程分支的实际大小写
git branch -r | grep -i s1

# 2. 重命名本地分支（假设远程是大写 S）
git branch -m feature/s1 tmp
git branch -m tmp feature/S1

# 3. 重新设置 tracking
git branch --set-upstream-to=origin/feature/S1

# 4. 此后可直接使用
git push
git pull

最佳实践

1. 统一命名规范：团队约定统一的分支命名格式（如全小写）
2. 创建分支时注意大小写：从远程 checkout 时使用正确的大小写
3. 定期检查 ：使用 git branch -vv 查看本地分支与 upstream 的关联情况

# 查看当前分支的 tracking 信息
git branch -vv

小结

Git 的大小写敏感特性在跨平台开发（Windows/macOS/Linux）时尤其容易引发问题。记住核心原则：本地分支名与远程分支名必须完全一致，包括大小写。遇到问题时，先确认远程实际分支名，再统一本地分支即可。