WebStorm看不到远程分支是因为未执行Fetch操作；需点击右下角分支指示器→Git Branches面板→点Fetch按钮更新remote-tracking分支，之后Remote Branches标签才显示真实远程分支。
WebStorm里看不到远程分支？先确认是否 fetch 过
右下角 Git 分支指示器点开后，Remote Branches 标签下为空，不是插件没装好，也不是 WebStorm 坏了——是本地还没从远程同步过分支引用。Git 的远程分支（如 origin/main）在本地只是缓存快照，存在 .git/refs/remotes/origin/ 下，不会自动更新。
必须手动触发同步：点击右下角分支名 → 弹出面板 → 点击左上角 Fetch 按钮（或菜单 VCS → Git → Fetch）。之后再看 Remote Branches，才会有真实内容。
- 如果 Fetch 后仍为空，检查项目根目录是否存在
.git，且 Settings → Version Control 已正确绑定该路径 - Fetch 不下载文件，只更新远程引用列表；不会改变工作区代码
- 频繁遇到“刚 push 的分支不显示”，大概率是同事 push 后你没 fetch ——这不是 WebStorm 延迟，是 Git 机制
想查远程仓库当前真实分支列表？别信本地缓存
git branch -a 显示的 remotes/origin/xxx 是本地缓存，可能已过期（比如别人删了分支，你还看见它）。要获取远程服务器此刻真实的分支清单，必须绕过本地状态：
打开 WebStorm 内置 Terminal（Alt+F12），执行：
git ls-remote --heads origin
输出类似：
abc123456789 refs/heads/main def987654321 refs/heads/dev ghi555555555 refs/heads/feat/payment
每行末尾 refs/heads/xxx 就是真实分支名。这个命令不依赖 .git 里的任何缓存，也不修改本地仓库，适合快速验证远程是否存在某分支。
- 若报
unable to access，检查 Git 凭据（如 token 是否过期）、网络或远程地址配置 - 不加
--heads会混入 tag，加了才只查分支 - 结果里没有
remotes/前缀——这是远程原始命名，和本地origin/xxx是两套逻辑
为什么 WebStorm 的 Branches 面板里远程分支名带 origin/？
WebStorm 在 Remote Branches 标签下显示的 origin/fix/login，本质是 Git 的 remote-tracking branch，即本地对远程分支的映射。它不是远程仓库上的真实分支名，而是 Git 为方便管理自动生成的本地引用。
这个前缀不可省略，也不能手动改掉——改了就断开了与远程的跟踪关系。例如：
- 你右键
origin/fix/login→Checkout，WebStorm 实际执行的是git checkout -b fix/login --track origin/fix/login - 如果误删了
origin/fix/login（比如执行了git branch -d -r origin/fix/login），再点 Fetch 就能恢复 - 远程分支被删后，本地
origin/xxx不会自动消失，得靠git fetch --prune清理
想一次性看清所有分支（本地 + 远程）的跟踪状态？用命令行补足
WebStorm 的图形界面不直接展示“哪个本地分支跟踪哪个远程分支”以及“ahead/behind 状态”。这时候最稳的方式是终端敲：
git branch -vv
输出示例：
main abc123 [origin/main: ahead 1, behind 2] Merge PR #42 * dev def456 [origin/dev] Add logging feat/auth ghi789 [origin/feat/auth: gone] Refactor auth flow
关键信息全在这里：
-
[origin/main: ahead 1, behind 2]：本地main比远程多 1 个提交，少 2 个提交 -
[origin/dev]：dev正常跟踪origin/dev -
[origin/feat/auth: gone]：远程分支已被删，本地还在跟踪——此时应运行git branch --unset-upstream
这个视图比 WebStorm 的 Branches 面板更精确，尤其在排查推送失败、合并混乱或分支消失时，git branch -vv 是第一手诊断依据。
