Java JGit如何删除远程仓库中除最新提交外的所有历史提交

首先要明确：Git的提交无法被直接"删除"，因为提交是Git的核心对象，只要有分支、标签等引用指向它，就会被保留。要实现仅保留最新提交的需求，本质是重写仓库历史，让远程分支只包含一个根提交（内容为原最新提交的内容），再强制推送到远程覆盖原有分支，旧提交会因为失去引用成为"孤儿对象"，后续被Git垃圾回收清理。

核心思路 #

1. 将本地仓库的当前状态（即原最新提交的内容）作为新的根提交
2. 用这个新的根提交分支强制覆盖远程分支
3. 远程仓库的旧提交因无引用指向，最终会被自动清理

JGit实现步骤及代码 #

1. 准备工作：确保本地仓库为最新状态 #

先拉取远程仓库的最新代码，保证本地内容和远程一致：

Repository repository = ...; // 打开本地仓库实例
Git git = new Git(repository);

// 拉取远程最新代码
git.pull()
   .setRemote("origin")
   .setRemoteBranchName("main")
   .call();

2. 创建孤立分支并提交当前内容 #

孤立分支没有任何历史提交，我们将当前工作区的所有内容提交为该分支的第一个（也是唯一）提交：

// 创建孤立分支（对应git checkout --orphan new-main命令）
git.checkout()
   .setCreateBranch(true)
   .setName("new-main")
   .setOrphan(true)
   .call();

// 暂存所有文件
git.add()
   .addFilepattern(".")
   .call();

// 提交为新的根提交
git.commit()
   .setMessage("Initial commit (only latest content retained)")
   .call();

3. 强制覆盖远程分支 #

将新分支推送到远程并覆盖原有分支：

// 强制推送新分支到远程，并重命名为原分支名（如main）
git.push()
   .setRemote("origin")
   .setForce(true) // 必须开启强制推送，因为历史已被重写
   .add("new-main:main")
   .call();

4. 清理本地分支（可选） #

如果不需要本地的临时分支，可以删除：

// 切换回main分支
git.checkout()
   .setName("main")
   .call();

// 删除本地的new-main分支
git.branchDelete()
   .setBranchNames("new-main")
   .call();

关键注意事项 #

• 远程仓库权限：GitHub默认禁止强制推送，需要在仓库的「Settings」→「Branches」中关闭对应分支的保护规则，或开启「Allow force pushes」选项。
• 协作者同步：仓库历史被重写后，所有协作者需要重新克隆仓库，或执行git fetch origin后用git reset --hard origin/main强制同步本地分支，否则会出现冲突。
• 旧提交清理：远程仓库的旧提交不会立刻消失，GitHub会定期运行垃圾回收（GC）清理无引用的对象，一般几天内会被彻底删除。

对之前尝试的说明 #

• DeleteBranchCommand仅删除分支引用，提交本身仍存在于仓库对象数据库中，只要有其他引用（如标签、旧分支备份）指向就不会被清理。
• RevWalk只能遍历提交，无法直接删除提交对象，因为Git的对象是不可变的，只能通过移除引用让其成为孤儿对象等待GC。

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