如何在Push/Pull前检测Git冲突并标记已修复？

问题背景 #

除分支合并外，Git还会在以下场景产生冲突：

• 提交/推送（仓库文件被多人同时修改时）
• 拉取（本地文件已被修改，远程有更新时）

想要在推送或拉取操作前列出冲突文件并标记修复，但调用git.status().call().getConflicting()无法获取到冲突文件，相关代码：

Status status = git.status().call();
status.getConflicting();

当前使用的部分代码片段：
拉取代码：

git.pull().setContentMergeStrategy(ContentMergeStrategy.CONFLICT).setCredentialsProvider( new FxGitCredentialsProvider( getDialogScene() )).call();

提交推送代码：

final AddCommand addCommand = git.add();
for ( String filePattern : filePatterns){
    addCommand.addFilepattern( filePattern );
}
addCommand.call();

git.commit().setMessage(messageTextArea.getText()).setCredentialsProvider( new FxGitCredentialsProvider( getDialogScene() )).call();
if ( push ){
   PushCommand pushCommand = git.push().setCredentialsProvider( new FxGitCredentialsProvider( getDialogScene()));
   pushCommand.call();
}

原因分析 #

JGit的Status.getConflicting()仅返回已进入合并状态的冲突文件（比如执行merge后产生的冲突），而你想要提前检测的是拉取/推送前的潜在冲突——这类冲突在本地仓库未执行拉取操作时，并不会被标记为已冲突状态，所以status方法无法捕获。

解决方案 #

1. 拉取前检测潜在冲突 #

要在拉取前检测本地修改与远程分支的冲突，需要先获取远程分支的最新内容，再对比本地文件：

// 获取远程仓库最新内容
FetchResult fetchResult = git.fetch().setCredentialsProvider(new FxGitCredentialsProvider(getDialogScene())).call();
// 获取本地分支和远程分支的引用
Ref localRef = git.getRepository().findRef("refs/heads/your-branch");
Ref remoteRef = git.getRepository().findRef("refs/remotes/origin/your-branch");

// 对比两个分支的文件差异，找出可能冲突的文件
ObjectReader reader = git.getRepository().newObjectReader();
CanonicalTreeParser localTree = new CanonicalTreeParser();
localTree.reset(reader, localRef.getObjectId());
CanonicalTreeParser remoteTree = new CanonicalTreeParser();
remoteTree.reset(reader, remoteRef.getObjectId());

List<String> conflictingFiles = new ArrayList<>();
DiffFormatter diffFormatter = new DiffFormatter(NullOutputStream.INSTANCE);
diffFormatter.setRepository(git.getRepository());
List<DiffEntry> diffEntries = diffFormatter.scan(localTree, remoteTree);

for (DiffEntry entry : diffEntries) {
    // 检查文件是否在本地有未提交或已暂存的修改
    Status status = git.status().addFilepattern(entry.getNewPath()).call();
    if (status.hasUncommittedChanges() || status.getAdded().contains(entry.getNewPath())) {
        conflictingFiles.add(entry.getNewPath());
    }
}

// 关闭资源
diffFormatter.close();
reader.close();

// conflictingFiles 即为拉取前可能冲突的文件列表

2. 推送前检测潜在冲突 #

推送前的冲突本质是本地提交与远程提交的内容冲突，需要先拉取远程最新内容并对比差异：

// 先拉取远程最新内容
git.fetch().setCredentialsProvider(new FxGitCredentialsProvider(getDialogScene())).call();
Ref remoteRef = git.getRepository().findRef("refs/remotes/origin/your-branch");
ObjectId remoteHead = remoteRef.getObjectId();
ObjectId localHead = git.getRepository().getRef("HEAD").getObjectId();

List<String> conflictingFiles = new ArrayList<>();
try (RevWalk revWalk = new RevWalk(git.getRepository())) {
    RevCommit localCommit = revWalk.parseCommit(localHead);
    RevCommit remoteCommit = revWalk.parseCommit(remoteHead);
    // 找到本地与远程分支的共同祖先提交
    RevCommit mergeBase = revWalk.parseCommit(git.getRepository().resolve(localHead + "..." + remoteHead));
    
    // 分别对比本地、远程与共同祖先的文件差异
    CanonicalTreeParser localTree = new CanonicalTreeParser();
    localTree.reset(git.getRepository().newObjectReader(), localCommit.getTree());
    CanonicalTreeParser baseTree = new CanonicalTreeParser();
    baseTree.reset(git.getRepository().newObjectReader(), mergeBase.getTree());
    CanonicalTreeParser remoteTree = new CanonicalTreeParser();
    remoteTree.reset(git.getRepository().newObjectReader(), remoteCommit.getTree());
    
    DiffFormatter diffFormatter = new DiffFormatter(NullOutputStream.INSTANCE);
    diffFormatter.setRepository(git.getRepository());
    List<DiffEntry> localDiffs = diffFormatter.scan(baseTree, localTree);
    List<DiffEntry> remoteDiffs = diffFormatter.scan(baseTree, remoteTree);
    
    // 找出两边都修改过的文件，即为潜在冲突文件
    Set<String> localModified = localDiffs.stream().map(DiffEntry::getNewPath).collect(Collectors.toSet());
    Set<String> remoteModified = remoteDiffs.stream().map(DiffEntry::getNewPath).collect(Collectors.toSet());
    localModified.retainAll(remoteModified);
    conflictingFiles.addAll(localModified);
    
    diffFormatter.close();
}

// conflictingFiles 即为推送前可能冲突的文件列表

3. 标记冲突已修复 #

手动修复冲突后，通过AddCommand将修复后的文件暂存，即可标记为已修复：

// 暂存单个修复后的文件
git.add().addFilepattern("path/to/conflicted/file").call();

// 批量暂存多个修复文件
AddCommand addCommand = git.add();
for (String conflictFile : conflictingFiles) {
    addCommand.addFilepattern(conflictFile);
}
addCommand.call();

关键说明 #

• Status.getConflicting()仅针对已触发合并操作的冲突，不适用于提前检测潜在冲突
• 提前检测冲突需要通过对比本地与远程的提交树差异实现，必须先fetch远程最新内容保证信息准确
• 标记冲突修复的核心是将修复后的文件纳入暂存区，确保后续提交/推送能识别修改

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