如何将无Blob的Git部分克隆推送到新远程而不拉取所有Blob？

场景说明 #

• 创建无Blob克隆：git clone --filter=blob:none https://example.com/a-repo.git
• 添加空远程仓库lite：git remote add lite https://example.com/b-repo.git
• 执行git push -u lite HEAD时，Git会自动从origin拉取所有Blob后再推送到lite，现在需要实现仅推送本地已有的提交、树和Blob，无需从origin拉取完整内容

移除origin后执行推送的报错信息（已翻译）：

GSLAL0320120132 % git push --verbose lite                                                                                                                                   23T20:24
推送至 file://Users/Ian/b-repo
枚举对象: 8, 完成.
统计对象: 100% (8/8), 完成.
使用最多8线程进行增量压缩
压缩对象: 100% (4/4), 完成.
fatal: 无法读取 5c20a7a001d205148607809eacabc4b3405d1aa0
error: 远程解包失败: 包头部未完全读取就遇到EOF
To file:///Users/icarroll/tmp/c-repo
 ! [远程拒绝] main -> main (解包错误)
error: 无法推送一些引用到 'file:///Users/Ian/b-repo'

解决方案 #

1. 用--no-fetch强制推送本地现有对象 #

直接在推送命令中添加--no-fetch参数，阻止Git自动拉取缺失对象：

git push --no-fetch -u lite HEAD

注意：如果本地提交对应的Blob确实缺失，推送仍会失败——这说明你要推送的提交依赖了本地没有的Blob，要么放弃推送该提交，要么手动拉取必要的Blob。

2. 临时配置跳过对象完整性检查（谨慎使用） #

通过配置让远程端解包时不强制检查对象完整性，适合明确只需要推送本地现有内容的场景：

git config transfer.unpackLimit 0
git push -u lite HEAD

⚠️ 风险：可能导致远程仓库出现不完整的提交（缺失Blob），后续如果需要完整使用该仓库会出问题，用完建议恢复配置：git config --unset transfer.unpackLimit

3. 精准拉取所需Blob后再推送 #

如果要推送的提交确实需要部分Blob，可以从origin仅拉取该提交对应的必要内容，而非全部：

# 拉取当前HEAD提交的必要Blob
git fetch --filter=blob:none origin HEAD

这样既不会拉取整个仓库的Blob，又能确保推送的提交对象完整，之后再执行常规推送即可。

报错原因分析 #

移除origin后推送失败，是因为本地提交对应的树对象引用了缺失的Blob（即报错中的5c20a7a001d205148607809eacabc4b3405d1aa0），此时Git无法从任何远程拉取该对象，生成的推送包不完整，远程端解包时检测到缺失就会拒绝。

内容的提问来源于stack exchange，提问作者Ian