LibGit2Sharp实现等效git log分支范围查询的正确CommitFilter配置

需要获取两个发布分支之间的全量提交，对应可正常返回预期结果的原生Git命令为：

git log release/v21.2.16..release/v21.3.2

该命令的核心逻辑是返回所有可从release/v21.3.2分支到达、但无法从release/v21.2.16分支到达的提交，即两个版本节点之间的全部历史记录。

尝试使用LibGit2Sharp的CommitFilter实现等效查询时，编写的代码如下：

var filter = new CommitFilter
{
    SortBy = CommitSortStrategies.Reverse | CommitSortStrategies.Time,
    ExcludeReachableFrom = repo.Branches[_baseBranch].Tip,
    IncludeReachableFrom = repo.Branches[_targetBranch].Tip
};
var results = repo.Commits.QueryBy(filter);
foreach (var r in results)
{
    Console.WriteLine($"{r.Sha} {r.Committer}");
    commits.Add(r.Sha);
}

实际运行结果与命令行输出存在本质差异：仅提交总数接近，具体提交哈希、提交者信息完全不匹配，属于巧合性的数量一致，而非集合内容对齐。

修正后的CommitFilter配置如下，可实现与原生命令完全一致的返回结果：

// 显式匹配本地分支引用，避免误取远程跟踪分支作为范围计算的根节点
var baseBranch = repo.Branches[_baseBranch, BranchMatchMode.LocalBranches];
var targetBranch = repo.Branches[_targetBranch, BranchMatchMode.LocalBranches];

var filter = new CommitFilter
{
    // 范围定义严格对齐Git双点语法的A..B规则
    IncludeReachableFrom = targetBranch.Tip,
    ExcludeReachableFrom = baseBranch.Tip,
    // 对齐原生命令的排序逻辑：
    // Time对应按提交时间倒序，Reverse反转顺序为从旧到新，与原有代码的排序预期一致
    SortBy = CommitSortStrategies.Time | CommitSortStrategies.Reverse,
    // 显式关闭第一父遍历，确保覆盖所有合并分支的提交，与git log默认行为一致
    FirstParent = false
};

var matchedCommits = repo.Commits.QueryBy(filter).ToList();

• 未显式设置FirstParent = false：部分LibGit2Sharp版本在组合排序策略时会隐式启用第一父遍历模式，仅沿着每个提交的第一父链回溯，会漏掉合并进目标分支的独立特性分支上的提交，导致返回的提交集合本身和原生命令不一致。
• 取分支引用时未指定匹配模式：如果仓库中存在同名的本地分支和远程跟踪分支，默认索引可能匹配到错误的分支引用，导致范围计算的根节点和命令行使用的本地分支不一致。
• 排序策略未显式限定时间维度：隐式配置可能导致排序使用作者提交时间而非提交记录时间，虽然不影响集合内容，但会和命令行输出顺序产生偏差。

验证时可逐行对比输出的SHA、提交者信息，与命令git log --format="%H %cn" release/v21.2.16..release/v21.3.2的输出即可达到完全一致。

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