点右下角分支名≠切换成功，必须进入Git Branches面板执行Checkout；远程分支需先Fetch更新remote-tracking分支，再Checkout才能正确检出代码。
点右下角分支名 ≠ 切换分支成功
WebStorm 右下角显示的 main 或 dev 只是当前分支快照，点击它弹出的是 Git Branches 面板入口，不是操作终点。很多用户点了没反应，或切过去文件没变，本质是误以为“点一下就完事”。
- 真正切换必须进
Git Branches面板 → 在Local标签下双击分支名，或右键 →Checkout - 如果面板空白，先检查项目根目录是否存在
.git；存在但无内容，执行Git → Repository → Refresh - 切分支前务必确认工作区干净：未提交修改会阻止切换，或触发
Shelve提示（可选自动暂存）
拉远程分支必须先 Fetch 再 Checkout
你在 Remote Branches 下看到 origin/fix/login-timeout，右键 Checkout 却提示 “no changes” 或失败，大概率是因为本地还没同步该分支的 commit 记录。
- 第一步永远是
Fetch：点右下角分支指示器 →Fetch，或菜单Git → Repository → Fetch - Fetch 完后，
Remote Branches里才真正有该分支的最新引用；此时再右键 →Checkout，WebStorm 才会创建同名本地分支并检出对应 commit - 别误点
Checkout Revision——那是按 commit hash 检出，不是分支 - 怀疑远程分支不存在？终端执行
git ls-remote --heads origin fix/login-timeout确认
推新分支报 “No tracking information” 怎么办
新建分支 bugfix/modal-close 并提交后，右键 → Push 弹出错误：The current branch bugfix/modal-close has no upstream branch。这不是权限问题，是 Git 缺少上游映射。
- 首次推送新分支时，WebStorm 默认不设
upstream，必须手动指定 - 正确做法：右键分支 →
Push→ 弹窗中勾选Set upstream，或点Configure旁小齿轮 → 选Push current branch as new branch to origin - 后续再 push 就无需重复设置；也可命令行补救：
git push -u origin bugfix/modal-close - 分支命名含
/（如feat/user-profile）会自动在 Git Branches 面板中分组，便于识别
合并失败时先看三件事
右键 Merge into Current 后没反应，或弹窗一闪而过，说明合并被静默跳过——常见于分支已合入、无新提交或工作区不干净。
- 检查目标分支是否已有源分支的全部提交：打开
Log标签页，对比两个分支的 commit 图谱 - 确认当前分支是否干净：
Local Changes面板为空，且无未提交修改 - 验证是否真的分叉：如果源分支只是从当前分支切出且没提交，Git 认为“无需合并”，直接 fast-forward（WebStorm 不提示）
- 强制触发合并？用命令行
git merge --no-ff origin/feat/xxx，再刷新 WebStorm Log
分支管理真正的复杂点不在操作按钮，而在状态同步时机：Fetch 不是“自动后台更新”，而是你决定何时让本地知道远程发生了什么。漏掉这一步，所有基于远程分支的动作都会失准。
