git bundle 是将 git 仓库的提交历史、分支、标签等元数据打包成单个二进制文件的离线传输方案，不包含工作区源码，适用于物理隔离网络迁移；导出用 git bundle create repo.bundle --all，导入需 git init && git fetch bundle --all 后 checkout 分支。
用 git bundle 实现跨物理隔离网络的源码迁移，核心是把整个仓库的 Git 元数据（提交、分支、标签、引用）打包成单个二进制文件，不依赖网络连接，适合摆渡机、U盘、光盘等离线介质传输。它不传工作区文件（即你写的源码文件本身），但完整保留所有历史记录、分支拓扑和 tag 时间点——只要目标环境有 Git，就能还原出和原仓库完全一致的本地仓库。
导出：打包全部分支与标签
在源仓库所在机器（有网络或可访问原 Git 服务端）执行：
-
最常用命令：
git bundle create repo.bundle --all这会打包所有本地分支（refs/heads/*）、所有标签（refs/tags/*）、所有必要提交对象及祖先关系，覆盖绝大多数迁移场景。 - 如需排除某些测试分支或临时分支，可显式列出：
git bundle create repo.bundle main develop release/v2.0 --tags - 执行前建议先运行
git fetch --all确保本地引用最新，避免漏掉远程分支的最新提交。
验证：确认 bundle 文件完整性
生成后别急着拷走，先本地校验是否能被 Git 正确识别：
-
git bundle verify repo.bundle—— 检查文件是否损坏、签名是否有效（如有） -
git bundle list-heads repo.bundle—— 列出该 bundle 包含哪些分支头，例如输出：12a3b4c refs/heads/main56d7e8f refs/heads/develop90g1h2i refs/tags/v1.3.0
若没看到关键分支或 tag，说明导出范围不对，需重新生成。
导入：在隔离网络中重建仓库
将 repo.bundle 复制到目标机器后，分两步还原：
-
新建空仓库并拉取数据：
mkdir my-project && cd my-projectgit initgit fetch ../path/to/repo.bundle --all
此时所有分支和 tag 已作为远程引用存入refs/remotes/bundle/（或类似命名空间），尚未出现在本地分支列表中。 -
创建本地分支并检出：
git checkout -b main origin/main（若原主分支叫main）
或批量创建所有主干分支：git for-each-ref refs/remotes/bundle/ --format='git checkout -b %(refname:short) %(refname)' | sh
标签自动可用：git tag可查看，git show v1.3.0可验证内容。
注意事项与避坑点
这是物理隔离环境下最稳妥的 Git 迁移方式，但几个细节容易导致失败：
- bundle 不含工作区文件（即你的 .c/.py/.js 等源码），只含 Git 数据库；还原后需
git checkout才能生成可编辑的代码目录。 - 不能直接
git push回原远程仓库，必须先git fetch到本地仓库，再按常规方式推送到新远端（如新 GitLab 地址）。 - 若目标机器 Git 版本过低（如
- 大仓库生成 bundle 可能较慢（几十秒到数分钟），属正常现象，纯本地计算，无需网络。
