如何在C#中通过指定Commit Hash读取仓库文件的指定行？

前置准备 #

先通过NuGet安装LibGit2Sharp包：

Install-Package LibGit2Sharp

实现步骤 #

1. 打开本地仓库并定位目标Commit

通过仓库路径初始化Repository实例，再用Commit哈希值找到对应的Commit对象。

2. 定位Commit中的目标文件

从Commit的根树（Tree）中，根据文件路径找到对应的Blob对象（Blob对应仓库中的文件内容）。

3. 读取文件内容并提取指定行

将Blob内容转换为字符串，按行分割后提取目标行（注意行号从1开始，数组索引要减1）。

完整代码示例 #

using LibGit2Sharp;
using System;
using System.IO;

class GitFileReader
{
    static string GetLineFromCommit(string repoPath, string commitHash, string filePath, int lineNumber)
    {
        // 打开本地Git仓库
        using var repo = new Repository(repoPath);
        
        // 根据哈希值获取指定Commit
        var commit = repo.Lookup<Commit>(commitHash);
        if (commit == null)
        {
            throw new ArgumentException("指定的Commit哈希不存在于本地仓库中");
        }

        // 从Commit的根树中查找目标文件
        var treeEntry = commit[filePath];
        if (treeEntry == null || treeEntry.TargetType != TreeEntryTargetType.Blob)
        {
            throw new FileNotFoundException("指定的文件在该Commit中不存在");
        }

        // 将Blob内容转换为字符串并按行分割
        var blob = (Blob)treeEntry.Target;
        using var reader = new StreamReader(blob.GetContentStream());
        var lines = reader.ReadToEnd().Split(new[] { Environment.NewLine }, StringSplitOptions.None);

        // 验证行号有效性并返回目标行
        if (lineNumber > 0 && lineNumber <= lines.Length)
        {
            return lines[lineNumber - 1].Trim();
        }
        else
        {
            throw new ArgumentOutOfRangeException(nameof(lineNumber), "行号超出文件内容范围");
        }
    }

    // 调用示例
    static void Main()
    {
        try
        {
            string repoRoot = @"C:\Your\Local\Repo\Path"; // 替换为你的本地仓库根路径
            string commitHash = "bc1fd7e96dabd2a3180e5fe7146885208c12f279";
            string filePath = "src/Example.cs"; // 替换为目标文件相对于仓库根的路径
            int lineNumber = 15; // 替换为要获取的行号

            string lineContent = GetLineFromCommit(repoRoot, commitHash, filePath, lineNumber);
            Console.WriteLine($"指定行内容：{lineContent}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"错误：{ex.Message}");
        }
    }
}

关键说明 #

• Repository.Lookup<Commit>(commitHash)：支持完整哈希或短哈希（只要能唯一标识Commit）。
• commit[filePath]：文件路径必须是相对于仓库根目录的路径，不能用绝对路径。
• 换行符处理用Environment.NewLine适配不同系统，也可根据实际文件换行符调整为"\n"或"\r\n"。
• using语句会自动释放Repository和StreamReader资源，避免内存泄漏。

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