如何用LibGit2Sharp统计本地待推送与远程待拉取提交数？

嘿，这个需求其实在LibGit2Sharp里有非常直接的实现方式，完全不用绕到Diff功能去统计文件变更——咱们直接通过提交范围查询就能拿到提交总数！

核心思路 #

要统计**Incoming（远程已更新本地未拉取）和Outgoing（本地已提交未推送）**的提交数，本质是比较本地分支和它跟踪的远程分支之间的提交差异：

• Incoming：远程分支比本地分支多出来的提交（需要拉取）
• Outgoing：本地分支比远程分支多出来的提交（需要推送）

LibGit2Sharp的CommitFilter类可以帮我们精准筛选出这两个范围的提交，然后直接计数就行。

完整代码示例 #

结合你给出的循环结构，这里是实现代码：

foreach (Repos r in config.Repos)
{
    using (var repo = new Repository(r.Path))
    {
        // 获取当前检出的分支（如果要指定分支，可替换为 repo.Branches["你的分支名"]）
        var localBranch = repo.Head;
        var remoteTrackedBranch = localBranch.TrackedBranch;

        // 先判断分支是否有跟踪远程分支，没有的话无法统计
        if (remoteTrackedBranch == null)
        {
            Console.WriteLine($"仓库 {r.Path} 的当前分支未关联远程分支，跳过统计");
            continue;
        }

        // 统计Incoming提交：远程有、本地未拉取的数量
        var incomingFilter = new CommitFilter
        {
            Since = localBranch.Tip,   // 从本地分支最新提交开始
            Until = remoteTrackedBranch.Tip  // 到远程分支最新提交结束
        };
        int incomingCommits = repo.Commits.QueryBy(incomingFilter).Count();

        // 统计Outgoing提交：本地已提交、未推送的数量
        var outgoingFilter = new CommitFilter
        {
            Since = remoteTrackedBranch.Tip,  // 从远程分支最新提交开始
            Until = localBranch.Tip   // 到本地分支最新提交结束
        };
        int outgoingCommits = repo.Commits.QueryBy(outgoingFilter).Count();

        // 输出结果
        Console.WriteLine($"=== 仓库 {r.Path} 提交统计 ===");
        Console.WriteLine($"待拉取提交数（Incoming）: {incomingCommits}");
        Console.WriteLine($"待推送提交数（Outgoing）: {outgoingCommits}\n");
    }
}

关键细节说明 #

1. 分支跟踪检查：如果本地分支没有设置跟踪远程分支（比如刚创建的本地分支），TrackedBranch会返回null，这时候要做容错处理，避免空引用异常。
2. Fetch的重要性：统计Incoming之前，必须确保已经执行过repo.Network.Fetch(remoteTrackedBranch.RemoteName)，否则远程分支的引用还是旧的，统计结果会不准确。
3. 提交范围逻辑：CommitFilter的Since和Until定义了提交的边界——查询的是能到达Until但无法到达Since的提交，正好对应两个分支之间的差异提交。

这样实现完全不需要处理文件变更，直接拿到你想要的提交总数，是最直接高效的方式。

内容的提问来源于stack exchange，提问作者Scott R. Frost