先执行git fetch origin获取远程分支元信息，再用git switch -c xxx --track origin/xxx（Git 2.23+）或git checkout -b xxx origin/xxx（旧版）创建并追踪本地分支。
git pull 报 “remote branch xxx not found” 怎么办
这不是远程真没了，而是本地压根没“看见”它。Git 的 git pull 默认只拉你当前分支已配置的上游，如果本地还没创建对应分支、也没 fetch 过元信息，它连该去哪找都不知道。
直接执行以下两步：
-
git fetch origin—— 把远程所有分支引用拉到本地refs/remotes/origin/xxx -
git switch -c xxx --track origin/xxx（Git 2.23+）或git checkout -b xxx origin/xxx（旧版）—— 创建本地分支并建立追踪
别用 git pull origin xxx 硬试，它不会自动创建本地分支，只会报错。
git push -u 报 “upstream branch does not exist” 是什么情况
这个错误说明你试图用 --set-upstream 绑定一个远程根本不存在的分支，比如 origin/main 还没在远程创建过。Git 要求上游分支必须已存在才能设置追踪，而推送动作本身才是创建它的唯一途径。
正确做法只有一条命令：
-
git push -u origin main—— 它会先推送 commit 创建origin/main，再立刻把本地main的 upstream 配置为它
别先跑 git branch --set-upstream-to=origin/main，它不触发推送，远程分支仍为空，后续 git push 还是失败。
如何安全清理本地已失效的远程分支引用
远程分支被删后，本地 refs/remotes/origin/xxx 不会自动消失，git branch -r 仍显示它，但 git show-ref origin/xxx 会报 not a valid ref。这类“幽灵引用”会影响自动补全、VSCode 分支列表，甚至导致 git pull 报错。
清理分两步走：
-
git remote prune origin—— 删除本地已不存在于远程的refs/remotes/origin/*引用（安全，只删 tracking refs） -
git fetch --prune origin—— 等价于上面加一次 fetch，更常用
注意：git branch -d -r origin/xxx 是手动删单个，不推荐；git gc 不管这个，它清理的是松散对象，不是 ref。
为什么 git fetch 后还是看不到新分支
大概率是 .git/config 里 remote.origin.fetch 配置被改坏了。比如只剩 +refs/heads/master:refs/remotes/origin/master，漏了 main 或通配符。
检查和修复方法：
-
git config --get-all remote.origin.fetch—— 看当前 fetch 规则 - 如果输出不是
+refs/heads/*:refs/remotes/origin/*，就重置：git config --replace-all remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*" - 改完必须再跑一次
git fetch origin才生效
企业私有 Git 服务（如 Gitea）有时会禁用 uploadpack.allowAnySHA1InWant，也会导致 git ls-remote 返回空，需联系运维确认服务端配置。
