如何使用jGIT追踪GIT文件位置变更？

一、Pull操作后追踪文件路径变更 #

执行Pull操作完成后，可通过仓库状态对象获取文件的路径变更（尤其是重命名/移动）：

• 先调用pullCommand.call()执行拉取，判断操作成功后，获取仓库状态
• 通过Status对象的getRenamed()方法拿到路径变更的文件映射，key为旧路径，value为新路径
• 同时也可通过getAdded()、getRemoved()等方法获取其他类型的文件变更

示例代码：

// 执行Pull操作
PullResult pullResult = pullCommand.call();
if (pullResult.isSuccessful()) {
    // 获取仓库当前状态
    Status status = git.status().call();
    // 遍历所有路径变更的文件
    Map<String, String> renamedFiles = status.getRenamed();
    for (Map.Entry<String, String> entry : renamedFiles.entrySet()) {
        System.out.println("文件路径变更：" + entry.getKey() + " -> " + entry.getValue());
    }
}

二、分支切换后追踪文件路径变更 #

切换分支后，通过对比切换前后的提交树，能更精准地追踪文件位置变化：

1. 切换分支前，先保存当前HEAD的提交ID
2. 执行分支切换操作
3. 获取新分支的HEAD提交ID，用DiffCommand对比两个提交的差异
4. 筛选出ChangeType.RENAME类型的差异，即为文件路径变更记录

示例代码：

// 保存切换前的HEAD提交
ObjectId oldHead = git.getRepository().resolve("HEAD");
// 执行分支切换
git.checkout().setName("目标分支名").call();
// 获取切换后的HEAD提交
ObjectId newHead = git.getRepository().resolve("HEAD");

// 对比两个提交的差异
List<DiffEntry> diffs = git.diff()
        .setOldTree(CanonicalTreeParser.create(oldHead, git.getRepository().newObjectReader()))
        .setNewTree(CanonicalTreeParser.create(newHead, git.getRepository().newObjectReader()))
        .call();

// 筛选路径变更的文件
for (DiffEntry diff : diffs) {
    if (diff.getChangeType() == DiffEntry.ChangeType.RENAME) {
        System.out.println("文件移动/重命名：" + diff.getOldPath() + " -> " + diff.getNewPath());
    }
}

三、注意事项 #

• 执行操作前尽量保证仓库无未提交的本地修改，避免干扰变更追踪结果
• Status适用于对比工作区/暂存区与当前HEAD的差异，DiffCommand可直接对比任意两个提交的差异，更适合跨分支的场景

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