默认只拉取默认分支是 Git 设计行为；需执行 git fetch origin 并确保 remote.origin.fetch 配置为 "+refs/heads/:refs/remotes/origin/"，才能在 git branch -r 中看到全部远程分支。
默认 git clone 只拉取远程默认分支（通常是 main 或 master），本地看不到其他分支 —— 这不是漏了，是 Git 的设计行为。要让所有远程分支都“可用”，得靠 git fetch 配合正确配置，而不是重克隆。
克隆后看不到 remote 分支？先确认 fetch 是否完整
执行 git clone 后，远程分支信息其实已下载到 .git/refs/remotes/origin/，但 git branch -a 不显示，往往是因为 remote.origin.fetch 配置不全。
- 检查当前 fetch 规则：
git config --get-all remote.origin.fetch - 正常应有类似
+refs/heads/*:refs/remotes/origin/*这一行 - 如果只有
+refs/heads/main:refs/remotes/origin/main这种单分支规则，说明 clone 时用了-b main或远程仓库配置了 sparse refspec - 修复方法：
git config --add remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"，再运行git fetch origin
用 git clone --single-branch 就别想看到其他分支
如果你或团队成员曾用过 git clone --single-branch -b dev https://...，那本地仓库从一开始就被限制只跟踪一个分支 —— 即使改了 remote.origin.fetch，git fetch 也只会按原始规则拉取。
- 验证方式：
git ls-remote --heads origin能列出所有远程分支名，但git branch -r为空 → 就是 single-branch 造成的 - 补救办法只有两个：
git fetch origin '*:*'（绕过配置强制拉全）或干脆重新git clone（不加--single-branch） - 注意：
git fetch origin '*:*'是临时操作，下次git fetch仍走配置规则，除非你已修正remote.origin.fetch
git branch -r 显示空？检查远程仓库是否真有多个分支
有时候你以为该有多个分支，但实际远程只有 main —— 尤其常见于刚初始化的仓库、CI 自动创建的临时分支（未推送）、或权限受限的私有仓库。
- 直接查远程真实状态：
git ls-remote --heads origin（不依赖本地缓存） - 输出为空或只有一行 → 远程确实没其他分支，不是本地问题
- 输出有多行但
git branch -r无显示 → 回头看上一条的 fetch 配置 - Gitee/GitLab 私有项目要注意：部分平台对未授权用户隐藏非默认分支，即使 URL 可访问
真正容易被忽略的是：远程分支名带斜杠（如 feature/login-v2）时，git checkout -b login-v2 origin/feature/login-v2 中的本地分支名不能含斜杠，否则会报错 invalid reference name；Git 本地分支名规范不允许 /，这是硬限制，不是配置问题。
