webstorm基于某次提交创建分支必须先双击该提交进入detached head状态，再通过右下角分支指示器或git branches面板新建分支；漏掉任一环节将导致分支为空壳。
点右下角分支名 ≠ 基于某个 Commit 创建分支
WebStorm 没有“基于某次提交直接建分支”的快捷入口。所谓“基于 Commit 创建分支”，本质是 git checkout -b new-branch <commit-hash></commit-hash>，而 WebStorm 把这个操作拆成了两步：先定位到那个 Commit，再从它出发新建分支。如果你在 Git Log 里右键某个提交却没看到“New Branch”，说明你还没真正选中它——得双击该提交，让编辑器顶部状态栏显示 HEAD is detached at abc1234，这时右下角分支指示器才会变成灰色，且 Git Branches 面板里的 New Branch 按钮才可用。
在 Git Log 里双击 Commit 后，New Branch 才生效
这是最容易卡住的一步。很多人在 Log 视图里点了某条提交，发现 New Branch 输入框不可用或点了没反应，就是因为没触发“detached HEAD”状态：
- 必须双击目标 Commit（不是单击，也不是右键 → Copy Hash）
- 确认右上角提示栏出现
HEAD is detached at xxx，且右下角分支名变灰 - 此时再点右下角分支指示器 → Git Branches 面板 → 左上角
+→ 输入新分支名 → 勾选Checkout branch - 不勾选 Checkout 的话，分支会建好但不会自动切过去，容易误以为失败
远程分支不存在时，不能靠“Checkout as new local branch”反向拉取
如果想基于一个远程尚不存在的 Commit（比如同事刚 push 到 origin/feat/api-v2 但你本地还没 fetch 过），别指望右键 Remote Branches 里找它——它根本不会显示。正确路径是：
- 先执行
Git → Repository → Fetch，确保所有 remote-tracking 分支同步 - 打开 Log 视图（
Alt+9→ 切到Log标签），用搜索框输入 commit hash 或关键词过滤 - 找到目标 Commit 后双击 → 进入 detached HEAD 状态 → 再新建分支
- 如果该 Commit 属于某个远程分支（如
origin/feat/api-v2），新建分支后记得右键新分支 →Push→ 勾选Set upstream，否则推送会报No tracking information
新建分支后文件没变？检查是否真检出了目标 Commit
现象：新建分支叫 revert-bug-123，但代码和 main 一模一样。大概率是你双击了错误的 Commit，或者新建分支时没勾选 Checkout，导致实际还在原分支上。验证方法很简单：
- 终端执行
git rev-parse HEAD，看输出是否等于你当初双击的那个 hash - WebStorm 右下角分支名旁边有没有显示
↑1或↓2—— 有说明已关联远程；没显示且 Log 里看不到新分支的提交，说明只是空壳分支 - 别依赖“分支名变了”就认为成功：右键新分支 →
Compare with Current Branch，如果提示 “No differences”，那基本就是空分支
