如何检索文件的历史记录？

Question

我遇到了另一个 libgit2 问题，非常感谢您的帮助。

我正在尝试检索文件历史记录，即更改此文件的提交列表。这似乎很不传统......据我所知，没有任何功能。

我能想到的唯一方法是使用修订行走 API 来迭代修订，检查附加到提交的树对象并在那里搜索给定文件，如果找到，则将提交添加到我的列表中，否则继续进行下一个提交。

但它对我来说看起来不是最佳的......

可能还有其他方法，例如，直接查看 .git 文件夹并在那里获取所需的信息？

非常感谢！

Answer 1

但它看起来对我来说不是最佳的......

你的方法是正确的。请注意，您必须应对：

• 普通重命名（相同的对象哈希，不同的树条目名称）
• 在同一提交中发生重命名和内容更新（不同的哈希，不同的树条目名称。需要文件内容分析和比较功能，这是libgit2 中不可用）
• 多个父历史记录（已合并的两个分支，并且同一文件已以不同方式修改到其中）

可能还有其他方法，例如，直接查看 .git 文件夹并在那里获取所需的信息？

尽管了解 .git 文件夹布局总是值得花时间，但恐怕这不会帮助您解决这个特定的文件历史记录问题。

注意：这个问题与这个 libgit2sharp 问题非常接近：How to get the影响给定文件的最后一次提交？

更新

拉取请求#963 添加了这个功能。

它自 LibGit2Sharp.0.22.0-pre20150415174523 预发布 NuGet 包起可用。

Answer 2

这主要是在libgit2的issues/495中遵循的。
即使它是在libgit2sharp中实现的（PR 963，用于 里程碑 22)，它在 libgit2 本身中仍然是“待抢夺的”。

该问题记录在 issues/3041：提供包装 revwalk 的日志功能< /a>.
问题中提到的方法用于 此 libgit2sharp示例并且可以进行调整使用 libgit2 转换为 C。在 3041 决议得到解决之前，它仍然是当前的解决方法。

Answer 3

如果使用 C#，此功能已添加到 LibGit2Sharp 0.22.0 NuGet Package< /a> （拉取请求 963）。您可以执行以下操作：

var fileHistory = repository.Commits.QueryBy(filePathRelativeToRepository);
foreach (var version in fileHistory)
{
    // Get further details by inspecting version.Commit
}

在我的Diff All Files VS Extension中（这是开源的，因此您可以查看代码），我需要获取文件的先前提交，以便我可以看到对文件中的文件进行了哪些更改给定的提交。这就是我检索文件先前提交的方式：

/// <summary>
/// Gets the previous commit of the file.
/// </summary>
/// <param name="repository">The repository.</param>
/// <param name="filePathRelativeToRepository">The file path relative to repository.</param>
/// <param name="commitSha">The commit sha to start the search for the previous version from. If null, the latest commit of the file will be returned.</param>
/// <returns></returns>
private static Commit GetPreviousCommitOfFile(Repository repository, string filePathRelativeToRepository, string commitSha = null)
{
    bool versionMatchesGivenVersion = false;
    var fileHistory = repository.Commits.QueryBy(filePathRelativeToRepository);
    foreach (var version in fileHistory)
    {
        // If they want the latest commit or we have found the "previous" commit that they were after, return it.
        if (string.IsNullOrWhiteSpace(commitSha) || versionMatchesGivenVersion)
            return version.Commit;

        // If this commit version matches the version specified, we want to return the next commit in the list, as it will be the previous commit.
        if (version.Commit.Sha.Equals(commitSha))
            versionMatchesGivenVersion = true;
    }

    return null;
}