GitHub Action中git bundle无法正常工作的原因排查

问题根源 #

GitHub Action默认的actions/checkout步骤是浅克隆（仅拉取最新1次提交），即便使用git bundle create --all打包，也只能包含浅克隆范围内的对象，缺失完整历史中的父提交，最终导致本地解包时出现找不到对象的错误。

解决方案 #

1. 修改Checkout步骤，拉取完整仓库历史 #

在GitHub Action工作流中，将actions/checkout的fetch-depth设置为0，确保拉取完整的仓库所有分支与历史：

- name: 拉取完整仓库代码
  uses: actions/checkout@v4
  with:
    fetch-depth: 0

2. 打包后添加完整性验证 #

打包完成后，执行git bundle verify命令验证bundle的完整性，提前发现问题并终止异常工作流：

- name: 创建Git Bundle
  run: git bundle create my-bundle.bundle --all

- name: 验证Bundle完整性
  run: git bundle verify my-bundle.bundle

3. 可选：确认Bundle包含所有引用 #

可添加命令查看bundle中包含的分支、标签，确保所有需要的引用都被打包：

- name: 查看Bundle中的引用
  run: git bundle list-heads my-bundle.bundle

本地验证 #

完成上述修改后，重新触发工作流并下载Release中的bundle，执行git clone .\my-bundle.bundle即可正常克隆包含完整历史的仓库。

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