git clone -b 指定分支默认仍下载所有远程分支引用，需加 --single-branch 才真正限制下载范围；搭配 --depth 1 可大幅减小体积和耗时；分支名错误时可用 git remote set-branches + git fetch --prune 修正，无需重克隆。
git clone -b 指定分支但拉到了其他分支？检查 --single-branch 是否遗漏
默认 git clone -b dev 会检出 dev 分支，但依然下载所有远程分支的引用（git branch -r 仍能看到 origin/main、origin/test 等）。这不是 bug，是 Git 的默认行为 —— 它只控制「检出哪个分支」，不控制「下载哪些分支信息」。
真正限制下载范围，必须加 --single-branch：
-
git clone -b dev --single-branch https://github.com/user/repo.git→ 本地git branch -r只显示origin/dev - 漏掉
--single-branch，克隆后磁盘多占几百 MB 是常态，尤其在分支数超 50+ 的仓库里 - CI/CD 流水线中建议始终带上，避免因无关分支引用引发意外 fetch 或 checkout 行为
只想拿最新代码，不关心历史？用 --depth 1 浅克隆
如果目标只是构建、测试或临时调试（比如跑一次脚本、查个配置），完整历史纯属冗余。加 --depth 1 能把克隆体积压到 1/10 甚至更低，耗时也常缩短 70% 以上。
但要注意代价：
- 无法执行
git log、git blame、git checkout <old-commit> -
git pull默认会失败（提示 “unshallow required”），需先git fetch --unshallow（前提是远程允许） - 组合使用更实用：
git clone -b main --single-branch --depth 1 https://github.com/user/repo.git
克隆完才发现分支名拼错了，或远端根本没这个分支？别删重来
运行 git clone -b typo-branch ... 报 fatal: Remote branch typo-branch not found，第一反应不是重输命令，而是确认事实：
- 先连网查真实分支列表：
git ls-remote --heads origin（注意大小写，Dev≠dev） - 若已克隆成功但分支不对（比如误克隆了
main），可用git remote set-branches origin 'target'+git fetch --prune清理本地残留的远程引用 - 再
git checkout -b target origin/target创建并切换 —— 比删目录重 clone 快得多，尤其对大仓库
SSH 和 HTTPS 协议对指定分支克隆有影响吗？没有，但认证方式决定体验
-b、--single-branch、--depth 这些参数与协议无关，HTTPS 和 SSH 都支持。区别在于后续操作的便利性：
- HTTPS：每次
git push需输密码或 Personal Access Token（PAT），适合临时、受限网络环境 - SSH：需提前配好
~/.ssh/id_ed25519.pub并添加到远端平台；之后所有操作免密，CI 中推荐用 SSH URL 配置 deploy key - 错误示例：
git clone -b feat/login https://gitlab.example.com/group/proj.git成功，但git push失败 —— 很可能是因为 HTTPS URL 写成了只读地址（如带https://但远端未开写权限），换 SSH 就绕过该问题
最易被忽略的一点：--single-branch 不是“可选优化”，而是“按需克隆”的必要条件；没它，所谓“只拉某一分支”只是假象 —— 你省下的不是时间，是后续排查引用污染的精力。
