git-bundle

把 Git 仓库打包成单文件传输

补充说明

git bundle 把提交和引用打包成一个文件，适合离线传输、内网导入和镜像同步。接收方可以像克隆普通仓库一样从 bundle 克隆或拉取。

常用示例

git bundle create repo.bundle --all
git bundle create main.bundle main
git bundle create update.bundle v1.2.0..main
git bundle verify repo.bundle
git clone repo.bundle app
git fetch repo.bundle main:refs/remotes/bundle/main
git bundle list-heads repo.bundle

易错点与排错

• bundle 里的引用范围要写清；只打 main 不会包含其他分支和 tag。
• 增量 bundle 需要接收方已有前置提交，否则 verify 会报缺少 prerequisite。
• git bundle create - 可输出到 stdout，但大仓库要注意管道和磁盘。
• 接收方用 git clone repo.bundle 时，bundle 必须包含 HEAD 指向的分支。
• bundle 不包含 reflog、未跟踪文件和不可达对象；不能替代完整备份。
• 传输后先 git bundle verify，确认引用和对象完整。
• 大文件放 LFS 时，bundle 只包含指针；接收方仍需 LFS 存储。

相关命令

• git — 版本控制
• git-archive — 导出源码快照
• git-lfs — 大文件