应使用 git clone -b <分支名> --single-branch <仓库URL>：-b 指定检出分支，--single-branch 确保仅下载该分支的引用和历史，避免拉取其他分支元信息；如只需最新代码，可追加 --depth 1 实现浅克隆。
git clone 只拉指定分支，避免下载整个仓库
默认 git clone 会拉取所有分支的全部历史，如果仓库大、分支多，既慢又占磁盘。想只拿某一分支（比如 dev 或 release/v2.3），关键不是靠后续 git checkout 切换，而是从克隆阶段就限制范围。
最直接有效的方式是用 --single-branch 加 -b：
git clone -b dev --single-branch https://github.com/user/repo.git
-
-b dev指定要检出的分支名（也支持 tag 名） -
--single-branch确保远程其他分支的引用不被下载，本地git branch -r只能看到 origin/dev - 如果不加
--single-branch，即使指定了-b，Git 仍会 fetch 所有分支的 ref，只是默认只检出那个分支
克隆时跳过历史，只取最新提交（浅克隆）
如果只需要代码快照，不关心 commit 历史（比如 CI 构建、临时调试），可以叠加 --depth 1：
git clone -b main --single-branch --depth 1 https://github.com/user/repo.git
-
--depth 1让克隆只拉最近一次提交，体积和耗时大幅下降 - 但代价是：无法
git log查历史、不能git blame追溯修改、也不能切换到该分支之前的任意 commit - 如果后续需要完整历史，可运行
git fetch --unshallow（前提是远程允许）或重新 clone
已克隆完才发现分支不对，怎么最小代价修正
如果已经 git clone 了完整仓库，但其实只想要其中某个分支，别急着删重来。可以清理掉无关远程分支引用，再重置本地状态：
- 删掉除目标分支外的所有远程跟踪分支：
git remote set-branches origin 'target-branch'，然后git fetch --prune - 删掉本地无用分支：
git branch -D branch-name（对每个非目标分支执行） - 确保当前在目标分支：
git checkout target-branch；如果它还没被检出，先git checkout -b target-branch origin/target-branch - 注意：
git remote prune origin不会删除远程分支，只清理本地已不存在的远程引用
遇到 fatal: Remote branch xxx not found 的常见原因
执行 git clone -b xxx 报这个错，基本不是命令写错了，而是远端根本不存在名为 xxx 的分支或 tag：
- 先确认分支是否存在：
git ls-remote --heads origin（看所有分支）或git ls-remote --tags origin（看所有 tag） - 分支名区分大小写，
Dev和dev是两个分支 - 某些仓库把开发分支命名为
develop而非dev，或使用main替代master - 私有仓库中，你的账号可能没权限读取该分支（HTTP 返回 403，但 Git 错误信息仍显示 “not found”）
真正麻烦的是：有些项目把功能分支推到远端后又删了，但你本地缓存了旧的 refs —— 这时候 git fetch --prune 能帮上忙，但首次 clone 时没法靠它解决。
