Git克隆后git branch只显示main或master，是因为默认仅下载远程默认分支的引用，其他远程分支未被拉取；需执行git fetch origin更新远程引用，再用git branch -a查看完整分支列表。
克隆后 git branch 只显示 main 或 master，其他分支哪去了？
不是分支丢了，是 Git 默认只下载远程的默认分支（通常是 main），其他分支的引用根本没拉下来。本地 git branch 只列出「已跟踪的本地分支」，而远程分支默认不自动创建对应本地分支，也不自动 fetch 元数据。
- 运行
git branch -r查看远程分支列表 —— 如果这里也为空或不全，说明连远程引用都没同步 - 先执行
git fetch origin，强制更新所有远程分支的最新 commit 信息 - 再用
git branch -a就能看到带remotes/origin/xxx前缀的远程分支了 - 想切到某个远程分支，比如
dev，直接运行git checkout dev（Git 2.23+ 推荐用git switch dev）—— Git 会自动创建同名本地分支并设置 upstream
为什么 git clone --single-branch 后死活看不到其他分支？
这个参数会让 clone 过程跳过所有非目标分支的 ref 数据，连 remotes/origin/ 下的记录都不会存。即使后续运行 git fetch origin，Git 也不知道该 fetch 哪些分支，因为远程引用列表本身就没被初始化。
- 确认是否用了
--single-branch或-b branch-name：检查git config --get remote.origin.fetch，正常应为+refs/heads/*:refs/remotes/origin/*；如果只有一行类似+refs/heads/main:refs/remotes/origin/main，就是被限制了 - 修复方法：手动重置 fetch 规则：
git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*" - 再执行
git fetch origin，所有分支就会重新出现在git branch -r里
切换远程分支时提示 error: pathspec 'xxx' did not match any file(s) known to git
这不是分支不存在，而是你试图用 git checkout xxx 切一个尚未建立本地跟踪关系的远程分支。Git 不会自动猜你想基于哪个远程分支创建本地分支。
Conventional Git
下载
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。
- 最稳写法：
git checkout -b xxx origin/xxx（Git git switch -c xxx --track origin/xxx（Git ≥ 2.23） - 别漏掉
origin/xxx—— 必须明确指定上游远程分支，否则 Git 不知道 base commit 从哪来 - 如果远程分支名含斜杠（如
feature/login-flow），确保 shell 没把它当路径解析：加引号或转义，例如git switch -c "feature/login-flow" --track origin/"feature/login-flow"
CI/CD 或自动化脚本里频繁遇到分支不可见，怎么预防？
很多 CI 环境默认用 shallow clone 或 single-branch 模式提速，但会彻底破坏分支可见性。不能依赖「人肉 fetch」，得在脚本里显式补全。
- 避免
git clone --depth=1，除非你确定只读默认分支；若必须 shallow，加--no-single-branch - 在 clone 后立即执行：
git fetch --prune --unshallow 2>/dev/null || git fetch --prune origin（兼容 shallow 和非 shallow 场景） - 检查分支是否存在再操作，别硬切：
git ls-remote --heads origin xxx | grep -q . && git switch xxx
远程分支信息本质是引用快照，不是实时服务。看不见，往往是因为本地缓存没刷新，而不是远端没了 —— 这点容易误判。
