WebStorm Git分支管理核心是：分支操作必须通过Git Branches面板执行，远程分支动作需先Fetch更新remote-tracking分支；新建/切换本地分支须在面板中操作并勾选Checkout；拉取远程分支需先Fetch再Checkout；推送新分支需手动设置upstream；合并无效时应检查提交状态、分支分叉及Git工作区是否干净。
WebStorm 的 Git 分支管理核心就两件事：分支创建/切换必须通过 Git Branches 面板触发，右下角分支指示器只是入口，不是操作终点；所有远程分支相关动作（拉新分支、推送、同步）都依赖本地 remote-tracking 分支是否最新——它不会自动更新，得手动 Fetch。
点右下角分支名 ≠ 切换成功，得进 Git Branches 面板操作
右下角显示 main 或 dev，点击后弹出的是 Git Branches 面板，不是快捷菜单。这里才是唯一可靠的操作界面：
- 新建本地分支：在面板左上角点
+→ 输入名字（如feat/profile-edit）→ 勾选Checkout branch才会真正切过去 - 切换已有本地分支：在
Local标签下双击分支名，或右键 →Checkout - 别用顶部菜单
VCS → Git → Branches：它和右下角入口是同一面板，但路径绕远，容易误点成“Compare”或“Rename” - 如果点了右下角却没反应，检查项目根目录是否存在
.git；若存在但面板空白，执行Git → Repository → Refresh
从远程拉新分支，必须先 Fetch 再 Checkout
你在 Remote Branches 下看到 origin/fix/login-timeout，右键 Checkout 却发现文件没变、提示 “no changes”，大概率是因为本地还没拿到这个分支的最新 commit 记录：
- 先点右下角分支指示器 →
Fetch（或Git → Repository → Fetch），确保origin/fix/login-timeout在本地已同步 - 再回到
Remote Branches→ 右键该分支 →Checkout，WebStorm 才会创建同名本地分支并检出对应 commit - 如果仍失败，检查是否误点了
Checkout Revision（那是按 commit hash 检出，不是分支） - 确认远程分支真实存在：
git ls-remote --heads origin fix/login-timeout
Push 新分支时报 “No tracking information”，要显式设置 upstream
你刚建好 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） - 等效命令是：
git push -u origin bugfix/modal-close，-u就是设置跟踪关系 - 设完之后，下次直接
Push就行，无需再选目标
合并后提示 “Already up to date” 却没代码变化，先查分支关系再动手
你在 dev 分支上右键 feat/search → Merge into Current，弹窗一闪而过，文件毫无动静。这不是 WebStorm 失效，而是 Git 判定无需合并：
- 先看
feat/search是否有未推送提交：git log origin/feat/search..feat/search，有输出说明本地有新 commit 没推 - 再查两个分支是否真有分叉：打开
Git → Log，按住Ctrl（Windows/Linux）或Cmd（macOS）多选dev和feat/search→ 右键 →Compare Branches，看是否有 diverged 提交 - 如果确实有差异但合并无效，试试
Rebase onto Current（尤其适合短生命周期功能分支） - 避免误用
--ff-only合并选项：它只允许快进合并，一旦有分叉就直接拒绝
最常被忽略的一点：WebStorm 的分支操作高度依赖 Git 底层状态是否干净。任何未提交更改、未暂存修改、甚至 .git/index 锁死，都可能导致 Checkout 或 Merge 行为异常——遇到“点不动”“没反应”，先看右下角 Git 状态栏有没有黄色感叹号或红色错误提示，再查 Git → Show History 里有没有 pending operation。
