如何克隆仓库的所有远程分支

普通 git clone 通常获取可见且 refspec 覆盖的分支历史，默认只建立一个本地分支；浅克隆等会限制范围。检出任意远程分支用 git checkout <分支名>。git clone --mirror 镜像可见引用；迁移前须确认目标可被覆盖，LFS 和子模块另行处理。

观测云编辑部 2026-09-28 3 分钟阅读更新于 2026-09-28

最佳实践

其实普通 git clone 通常获取服务器可见且 fetch refspec 覆盖的远程分支历史；浅克隆、single-branch、partial clone 和访问权限会限制范围——git branch -r 能看到本地已有的 origin/* 跟踪引用，git checkout 分支名 即可为任一远程分支建本地分支。镜像服务器可见引用可用 git clone --mirror；隐藏引用、LFS 和子模块不在此保证内。

普通克隆后检出其他分支

git clone https://github.com/org/repo.git
cd repo
git branch -r              # 查看所有远程分支
git checkout develop       # 自动建本地跟踪分支

批量为所有远程分支建本地分支

git for-each-ref --format='%(refname:strip=3) %(symref)' refs/remotes/origin/ |
while read -r branch symbolic; do
  [ -n "$symbolic" ] && continue
  git show-ref --verify --quiet "refs/heads/$branch" && continue
  git branch --track "$branch" "origin/$branch" || exit 1
done

一般没必要这么做——用到哪个检出哪个更符合 Git 的习惯。

完整镜像（迁移仓库用）

git clone --mirror https://github.com/org/repo.git repo.git
# 得到裸仓库（无工作区），含所有分支/tag/引用

# 仅向确认可被完整替换的目标迁移；mirror 会强制更新并删除目标多余引用
cd repo.git
git push --mirror https://gitlab.com/org/repo.git

--mirror vs --bare：mirror 是"完全克隆包括远程跟踪引用"，bare 只转换分支结构。仅在确实需要镜像所有可见引用且目标允许覆盖时使用 --mirror；平台隐藏引用、LFS 对象和子模块仓库仍需单独处理。