如何在LibGit2Sharp中实现允许无关历史的git pull操作？

刚好之前踩过类似的坑，先给你梳理清楚：git pull本质是**拉取远程分支（fetch） + 合并到本地分支（merge）**的组合操作，而--allow-unrelated-histories是合并阶段的核心参数。LibGit2Sharp的Commands.Pull方法目前没有直接支持这个参数，所以得拆成手动步骤来实现，同时解决你遇到的NonFastForwardException问题。

一、完整等价操作步骤 #

1. 先拉取（Fetch）远程分支内容 #

首先确保远程仓库已添加，然后拉取目标分支的最新内容：

using (var repo = new Repository(repoPath))
{
    // 添加远程仓库（如果之前没配置过）
    Remote remote = repo.Network.Remotes.Add("newRemote", targetRepositoryUrl);
    
    // 拉取远程分支，带上凭证信息
    repo.Network.Fetch(remote, new FetchOptions { CredentialsProvider = yourCredentials });
}

2. 执行允许无关联历史的合并（Merge） #

接下来把远程的newRemote/master合并到本地的wikiMaster分支，这里必须显式开启AllowUnrelatedHistories选项：

using (var repo = new Repository(repoPath))
{
    Branch localBranch = repo.Branches["wikiMaster"];
    Branch remoteBranch = repo.Branches["newRemote/master"];
    
    // 配置合并选项，核心就是允许无关联历史合并
    var mergeOptions = new MergeOptions
    {
        AllowUnrelatedHistories = true,
        // 如果需要自动处理简单冲突，可以添加ConflictHandler逻辑，这里先留空
    };
    
    // 执行合并操作
    MergeResult mergeResult = repo.Merge(remoteBranch, sig, mergeOptions);
    
    // 检查合并结果，有冲突的话必须先处理
    if (mergeResult.Status == MergeStatus.Conflicts)
    {
        throw new InvalidOperationException("合并出现冲突啦，得先解决冲突再继续推送哦");
    }
}

二、为什么你会遇到NonFastForwardException？ #

你直接用Commands.Pull的时候，因为默认不允许无关联历史合并，这个操作其实没有真正成功（就像你在Git命令行里直接拉取无关联分支会报错一样）。此时本地分支的HEAD并没有前进到包含远程内容的状态，推送时自然会因为本地分支和远程分支历史不兼容，触发“非快进”的异常。

三、修复后的完整可运行代码 #

把上面的步骤整合，确保合并成功后再执行推送：

using (var repo = new Repository(repoPath))
{
    // 1. 添加远程仓库（如果不存在）
    Remote remote = repo.Network.Remotes.Add("newRemote", targetRepositoryUrl);
    
    // 2. 拉取远程分支最新内容
    repo.Network.Fetch(remote, new FetchOptions { CredentialsProvider = yourCredentials });
    
    // 3. 获取本地分支和远程分支的引用
    Branch localBranch = repo.Branches["wikiMaster"];
    Branch remoteBranch = repo.Branches["newRemote/master"];
    
    // 4. 配置合并选项，允许无关联历史
    var mergeOptions = new MergeOptions
    {
        AllowUnrelatedHistories = true,
    };
    
    // 5. 执行合并并检查结果
    MergeResult mergeResult = repo.Merge(remoteBranch, sig, mergeOptions);
    if (mergeResult.Status != MergeStatus.Succeeded)
    {
        throw new InvalidOperationException($"合并失败啦，状态：{mergeResult.Status}");
    }
    
    // 6. 设置本地分支的上游关联（方便后续拉取/推送操作）
    repo.Branches.Update(
        localBranch,
        b => b.Remote = "newRemote",
        b => b.UpstreamBranch = remoteBranch.CanonicalName
    );
    
    // 7. 推送合并后的分支到远程
    var pushOptions = new PushOptions { CredentialsProvider = yourCredentials };
    repo.Network.Push(localBranch, pushOptions);
}

几个关键提醒 #

• 一定要等合并成功（mergeResult.Status为Succeeded）再推送，不然本地分支状态异常，必然触发推送失败。
• 如果合并出现冲突，得先手动解决冲突（可以通过代码操作索引，或者让用户手动修改文件后提交），才能继续后续操作。
• 合并后设置上游关联，后续的拉取、推送操作会更省心，不用每次指定远程仓库和分支。

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