快捷键切换分支仅支持已检出的本地分支，不显示远程分支；未检出的远程分支需先Fetch再Checkout，且切换前必须处理未提交修改，否则会因Git安全机制中断。
快捷键切换分支只支持本地分支，不显示远程分支
WebStorm 的快捷键 Ctrl+Shift+`（Windows/Linux）或 Cmd+Shift+`（macOS）调出的是「Git Quick Popup」，它只列出当前已存在的本地分支，origin/feature/login 这类远程分支不会出现。如果你刚从远程拉了一个新分支但没 Checkout 过，它就不会出现在这个弹窗里。
常见错误现象：按快捷键后弹出列表只有 main 和 dev，明明远程有 feat/dashboard 却找不到 —— 说明该分支还没被检出为本地分支，得先去 Git Branches 面板里 Fetch 再 Checkout 一次。
- 快捷键本质是快速触发
git checkout <branch>，不带-b或--track参数，所以无法创建或跟踪新分支 - 如果列表为空，检查项目根目录是否有
.git；若存在但无分支，执行Git → Repository → Refresh - 该弹窗不支持模糊搜索，分支名过长或相似时容易选错，建议双击确认前看一眼完整名称
切换前未提交/暂存的修改会导致快捷键失效或中断
当你有未提交的修改（modified 状态），快捷键弹窗仍会打开，但选中分支后 WebStorm 会卡在「Switching branch...」并弹出提示：「Your changes would be overwritten」。这不是快捷键坏了，而是 Git 拒绝覆盖工作区。
此时你只有三个选择：Commit、Shelve 或 Discard，没有「强制切换」选项。误点关闭弹窗只会让焦点回到编辑器，分支没切过去。
- 快捷键不绕过 Git 的安全机制，它和面板操作走同一套校验逻辑
-
Stash是最常用解法，但注意 WebStorm 默认 stash 不包含未跟踪文件（untracked files），如有新增文件需勾选Include untracked files - 如果只是临时查看另一分支，用
Git → Repository → Create Patch保存当前修改快照，比 commit 更轻量
快捷键切换后文件树没刷新？可能是 HEAD 处于分离状态
按快捷键选中一个分支后，右下角分支名变了，但编辑器里文件内容还是旧的，或者 Git 面板显示 HEAD detached at abc1234 —— 这说明你上次误点了 Checkout Revision（比如从 Log 中直接点某个 commit），导致当前 HEAD 不再指向分支引用，而是一个孤立提交。
这种状态下，快捷键依然能“切换”，但它只是把 HEAD 移到另一个 commit，而不是切换分支指针。所以你看不到分支特有的文件结构变化。
- 验证方式：终端运行
git symbolic-ref HEAD，正常应输出refs/heads/main；若报错「not a symbolic ref」，就是 detached HEAD - 修复方法：在
Git Branches面板的Local标签下，右键目标分支 →Checkout，强制重置 HEAD - 别依赖右下角分支名判断是否成功，要看
git status输出第一行是否为On branch xxx
高频切换时快捷键不如面板双击稳定
虽然快捷键快，但在分支数量多（>10）、命名含斜杠（如 release/2.3.1）或存在同名远程/本地分支时，键盘导航容易选错。比如按方向键跳过 feat/api-v2 直接落到 origin/feat/api-v2 上（尽管它不该出现），结果触发无效操作。
真正可靠的高频切换路径其实是：呼出面板 → Local 标签 → 双击分支名。这个动作不依赖键盘输入顺序，也不受命名干扰，且双击瞬间就完成 checkout，比快捷键多一层确认更少出错。
- 快捷键适合「已知存在且唯一」的分支，比如日常在
main/dev间切 - 面板双击是 WebStorm 唯一明确绑定
git checkout -f <branch>行为的操作，底层更干净 - 如果经常切错，关掉
Settings → Version Control → Git → Show git branches popup on shortcut，改用面板
