git bundle 是一个非常实用的 Git 工具，它允许你将一个 Git 仓库的提交历史打包成一个单独的文件，方便在没有网络连接或者不方便直接克隆仓库的情况下传输和分享代码。以下是 git bundle 常见使用场景及对应的实例。

1. 创建包含单个分支所有提交的 bundle 文件

假设你有一个本地仓库，里面有一个 master 分支，你想把这个分支的所有提交打包成一个 bundle 文件，方便传输给他人。

# 进入你的 Git 仓库目录
cd /path/to/your/repository# 创建一个名为 master.bundle 的文件，包含 master 分支的所有提交
git bundle create master.bundle master

2. 创建包含多个分支提交的 bundle 文件

如果你需要将多个分支（例如 master、feature1 和 feature2）的提交都打包到一个 bundle 文件中，可以这样操作：

# 进入仓库目录
cd /path/to/your/repository# 创建一个名为 all_branches.bundle 的文件，包含 master、feature1 和 feature2 分支的提交
git bundle create all_branches.bundle master feature1 feature2

3. 创建包含特定提交范围的 bundle 文件

有时候你可能只需要打包某个提交范围的内容，比如从某个提交到另一个提交之间的所有提交，或者某个提交及其之后的所有提交。

打包从某个提交到另一个提交之间的所有提交

# 进入仓库目录
cd /path/to/your/repository# 假设起始提交哈希为 abc123，结束提交哈希为 def456
git bundle create range.bundle abc123..def456

打包某个提交及其之后的所有提交

# 进入仓库目录
cd /path/to/your/repository# 假设起始提交哈希为 ghi789，打包从该提交到当前分支最新提交的所有内容
git bundle create since_commit.bundle ghi789..HEAD

4. 验证 bundle 文件的有效性

在创建完 bundle 文件后，你可以验证它是否包含有效的提交对象：

# 验证 master.bundle 文件的有效性
git bundle verify master.bundle

如果 bundle 文件有效，Git 会输出类似以下信息：

The bundle contains 10 commits
The bundle requires these 0 refs

5. 使用 bundle 文件克隆一个新的仓库

当你把 bundle 文件传输给他人后，对方可以使用该文件克隆出一个新的仓库：

# 在合适的目录下执行克隆操作，将 master.bundle 克隆到 new_repo 目录
git clone master.bundle new_repo

6. 从 bundle 文件拉取提交到现有仓库

如果你已经有一个本地仓库，想要把 bundle 文件中的提交合并到这个现有仓库，可以使用 git fetch 命令：

# 进入现有仓库目录
cd /path/to/existing/repository# 从 master.bundle 文件中拉取 master 分支的提交到本地的 master 分支
git fetch master.bundle master:master

通过以上实例，你可以全面了解 git bundle 的使用方法，方便在不同场景下进行代码的打包、传输和恢复操作。