git clone --depth 1 拉不下最新代码是因为它仅获取分支顶端一次提交，若远程发生 force-push 或分支重写导致该提交被删，clone 就会因引用缺失而失败。
git clone --depth 1 为什么拉不下来最新代码？
因为 --depth 1 只取每个分支最顶端那次提交，如果远程有 force-push 或分支重写，HEAD 指向的提交可能被删了——这时 clone 会失败，报错 remote: error: Object not found。不是网络问题，是浅克隆和 Git 引用完整性冲突。
实操建议：
- 优先用
--shallow-since="2 weeks ago"替代固定 depth，它按时间抓最近提交，对重写更友好 - 如果必须用 depth，加
--no-single-branch，否则默认只 fetch 当前默认分支（常被忽略） - 遇到
fatal: remote error: upload-pack: not our ref，说明某些 ref 已不可达，换--shallow-exclude=<code>commit-hash排除坏引用
git fetch --deepen=5 后为什么 log 还是只看到 1 条？
因为 git log 默认只显示当前 HEAD 可达路径上的提交；浅克隆里没有父提交对象，即使 fetch 加深了，历史链仍是断的。不是没拉到，是 Git 不认为那些提交“可达”。
实操建议：
- fetch 后立刻运行
git log --all --oneline，强制遍历所有 ref（包括origin/main），才能看到新拉的提交 - 如果要让
git log默认显示加深后的范围，执行git config advice.shallowUpdate false，避免 Git 自动修剪 - 注意
--deepen不会自动更新本地分支指针，需手动git merge-base origin/main HEAD判断是否已包含
CI 场景下 shallow clone 失败率高，怎么稳住？
CI 环境常并发触发、缓存复用，而浅克隆依赖远程 ref 的稳定性。一旦上游在 clone 过程中推送新提交，--depth 计算可能错位，导致 checkout 失败或检出错误 commit。
实操建议：
- 用
git clone --filter=blob:none替代--depth，它不依赖提交深度，而是按对象类型过滤，对 CI 更鲁棒 - 配合
-b main --single-branch明确限定分支，避免 Git 尝试同步其他 stale branch refs - 在 CI 脚本开头加校验：
git cat-file -e $(git rev-parse origin/main) 2>/dev/null || git fetch --prune，防 ref 失效
shallow repo 能不能 push 回远程？
能，但有限制：Git 允许 push，前提是你要推的 commit 都在远程已有历史中“可达”。浅仓库自己看不到完整祖先链，所以如果本地改了老文件、又没 fetch 全历史，push 时会报 ! [rejected] main -> main (non-fast-forward) ——不是权限问题，是服务端发现缺少必要 base commit。
实操建议：
- push 前先
git merge-base origin/main HEAD，输出为空说明 base 断了，必须git fetch --unshallow（慎用，可能拉几百 MB） - 日常开发别长期停留在 shallow repo 里，CI 用完即弃，本地开发用完整 clone
- 如果只是想提 PR，用
git format-patch生成补丁更安全，完全绕过 shallow 限制
浅克隆真正的坑不在“拉得慢”，而在它悄悄隐藏了 Git 的引用依赖关系——你以为只少下了几个 commit，其实丢掉的是整个可达性图谱。处理分支切换、rebase、submodule 更新时，这点最容易突然崩。
