git克隆单分支后看不到其他远程分支，是因为--single-branch或-b参数限制了仅下载指定分支的引用，.git/config中fetch规则被固化为单分支，导致refs/remotes/origin/*下缺少其他分支指针；需手动修改fetch规则并执行git fetch origin才能同步全部远程分支。

克隆单分支后 git branch 为什么看不到其他远程分支？

因为你用的是 git clone --single-branch（或 git clone -b xxx），Git 默认只拉取指定分支的提交和引用，refs/remotes/origin/* 下其他远程分支的指针根本没下载下来。这不是 bug，是设计如此——节省带宽和本地空间。

常见现象：git branch -r 只显示 origin/main（或你指定的那个分支），git checkout -b feat/login origin/feat/login 报错 error: pathspec 'origin/feat/login' did not match any file(s) known to git。

• 确认是否单分支克隆：检查 .git/config 中是否有 remote "origin" 段落含 fetch = +refs/heads/main:refs/remotes/origin/main（只有一行 fetch 规则）
• 想看所有远程分支？先运行 git remote set-branches origin '*'
• 再执行 git fetch origin，这时 git branch -r 才会列出全部 origin/* 分支

git checkout -b new-branch origin/existing-branch 失败怎么办？

即使 fetch 完了，直接 checkout 远程分支名仍可能失败——因为 Git 不知道该远程分支对应的 commit ID，除非它已存在于本地 reflog 或你显式 fetch 过。

Cnb Cool Git

CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。

下载

• 最稳做法：先 git fetch origin existing-branch（只 fetch 那个分支，不拉全量）
• 再 git checkout -b new-branch origin/existing-branch
• 如果提示 “already exists”，说明本地已有同名分支，加 -B 强制重置：git checkout -B new-branch origin/existing-branch
• 注意：origin/existing-branch 是远程跟踪分支名，不是字符串 "existing-branch"；少写 origin/ 就会报错

后续新建分支时，如何避免反复 fetch？

每次都要手动 git fetch origin xxx 很麻烦，但又不想一上来就 git fetch --all（尤其大仓库）。

• 推荐改 fetch 规则：编辑 .git/config，把 fetch = +refs/heads/main:refs/remotes/origin/main 改成 fetch = +refs/heads/*:refs/remotes/origin/*
• 改完后，下次 git fetch origin 就会同步所有远程分支指针（不下载文件，只更新引用）
• 或者设为全局默认：git config --global remote.origin.fetch '+refs/heads/*:refs/remotes/origin/*'，但仅对新克隆生效
• 注意：改完 fetch 规则后，必须再执行一次 git fetch origin 才能生效

为什么 git clone -b dev --single-branch 后 git switch -c foo origin/main 还是失败？

因为 --single-branch 不仅限制初始 fetch，还会在 .git/config 中硬编码只跟踪那个分支，后续 fetch 默认沿用这个限制，哪怕你改了 fetch 规则也不自动覆盖。

• 关键动作：删掉 .git/config 里 [remote "origin"] 下原有的 fetch 行，再按上一条补上通配规则
• 或者用命令一步到位：git config --replace-all remote.origin.fetch '+refs/heads/*:refs/remotes/origin/*'
• 然后 git fetch origin —— 这次才会真正拉下 origin/main 的 ref
• 容易忽略的点：git fetch 不加参数时，默认只 fetch 当前 remote 的默认 fetch 规则，不是“所有已知分支”

真正卡住人的，往往不是命令记不住，而是 fetch 规则被 clone 时固化、且不显眼地藏在配置里。