使用git worktree add创建分支却意外重命名远程分支的问题

操作背景与步骤 #

我需要从指定分支创建两个新工作树及对应分支：

• GTEC-426-eth 基于 feature/eth_testing
• GTEC-426-ksz 基于 feature/KSZ8851SNL_testing

执行的创建命令：

git worktree add -b GTEC-426-eth ../worktrees/GTEC-426-eth feature/eth_testing
git worktree add -b GTEC-426-ksz ../worktrees/GTEC-426-ksz feature/KSZ8851SNL_testing

完成代码修改后推送至远程仓库：

git push --set-upstream origin GTEC-426-eth
git push --set-upstream origin GTEC-426-ksz

异常现象 #

查看GitLab提交图发现：预期的新分支并未创建，原有的feature分支反而被修改；使用tig工具查看GTEC-426-ksz分支的提交历史，也显示异常。

参考Git手册说明 #

查阅git worktree手册中-b/-B参数的定义：

-b <new-branch>, -B <new-branch>
          With add, create a new branch named <new-branch> starting at <commit-ish>, and check out <new-branch> into the new working tree. If <commit-ish> is omitted, it defaults to HEAD. By default, -b refuses to create a new
          branch if it already exists.  -B overrides this safeguard, resetting <new-branch> to <commit-ish>.

疑问 #

我在Windows/WSL环境下操作，怀疑是系统大小写识别问题导致-b被误识别为-B，进而引发异常。请问我哪里操作出错了？

分析与解决方案 #

1. 排除大小写误识别的可能 #

Git的命令参数是严格区分大小写的，WSL环境下Git直接运行在Linux子系统中，命令行参数由Git自身解析，不受Windows文件系统大小写不敏感规则的影响，因此-b不会被误识别为-B，这个怀疑不成立。

2. 核心问题：目标分支已存在 #

-b参数的行为是如果目标分支已存在则直接报错终止，而-B会强制重置该分支。你遇到的异常更可能是以下情况：

• 执行创建命令前，GTEC-426-eth或GTEC-426-ksz分支已经存在，且恰好指向原feature分支的提交；
• 可能之前的操作残留了同名分支，导致git worktree add -b命令未执行成功，但你没注意到错误提示，后续在原分支上做了修改并推送，误以为是新分支的操作。

3. 验证与修复步骤 #

步骤1：检查本地分支状态

执行命令查看所有本地分支的指向与关联信息：

git branch -vv

确认GTEC-426-eth、GTEC-426-ksz以及原feature分支的提交节点和远程关联情况。

步骤2：检查工作树状态

查看当前所有工作树的关联信息：

git worktree list

确认新创建的工作树是否正确绑定了目标分支。

步骤3：清理异常资源并重新创建

如果发现分支或工作树关联错误，先清理异常项：

# 删除异常工作树
git worktree remove ../worktrees/GTEC-426-eth
git worktree remove ../worktrees/GTEC-426-ksz

# 删除本地错误分支
git branch -D GTEC-426-eth
git branch -D GTEC-426-ksz

然后重新执行创建命令，注意观察输出是否提示“创建新分支”的成功信息：

git worktree add -b GTEC-426-eth ../worktrees/GTEC-426-eth feature/eth_testing
git worktree add -b GTEC-426-ksz ../worktrees/GTEC-426-ksz feature/KSZ8851SNL_testing

步骤4：推送前确认分支指向

进入新工作树目录，执行命令确认分支历史：

git log --oneline --graph

确认当前分支的提交历史基于目标feature分支后，再执行推送命令。

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