Git对象存储需用LibGit2Sharp而非File类直接读写，因其自动处理zlib解压、header解析、SHA-1校验等细节；手动实现易出错且难以兼容Git规范。
Git对象存储结构决定了不能直接用File类读写
Git把所有对象（blob、tree、commit、tag）以SHA-1哈希值为文件名，压缩后存放在 .git/objects/ 下的两级子目录中（如 ab/cdef123...）。直接用 File.ReadAllBytes 读取会得到 zlib 压缩流，且内容是 Git 自定义格式（含 header + \0 + payload），不是原始文本或二进制数据。强行解压或解析 header 错误会导致乱码或崩溃。
- blob 对象开头是
blob {size}\0{content}，必须先提取 size 才能截取有效载荷 - tree 对象是二进制序列化格式（mode + null + name + null + sha），不能当文本处理
- commit 对象虽是文本，但头部有固定字段（
tree、parent、author等），换行符必须是 LF，且末尾需有双换行
推荐用 LibGit2Sharp 而非手撕 zlib 和 Git 格式
LibGit2Sharp 是 C# 生态最成熟的 Git 绑定库，封装了对象读写、引用解析、Odb 访问等底层能力，避免重复实现易出错的细节。它直接对接 libgit2 的原生 ODB（Object Database）接口，支持内存和磁盘两种后端，能正确处理 zlib 解压、header 解析、SHA-1 校验、delta 解包等。
- 读 blob：用
repo.Lookup<Blob>(sha)，返回的Blob.Content是解压并剥离 header 后的原始字节 - 写 blob：用
repo.ObjectDatabase.CreateBlob(content)，自动计算 SHA、压缩、写入两级路径 - 读 tree 或 commit：同样用
Lookup<Tree>或Lookup<Commit>，字段已结构化解析，无需手动切分
注意：初始化时需确保 repo 指向有效工作区根目录（即包含 .git 的父目录），而非直接指向 .git 文件夹本身。
如果坚持绕过 LibGit2Sharp，必须自己处理 zlib 和 Git header
仅建议用于学习或极轻量场景（如只读单个 blob）。核心步骤是：拼出对象路径 → 读取 zlib 流 → 解压 → 剥离 Git header → 提取 payload。header 格式为 {type} {size}\0，其中 {type} 是 "blob"/"tree"/"commit"/"tag"，{size} 是 ASCII 十进制数，\0 是单字节空字符。
var path = Path.Combine(gitDir, "objects", sha.Substring(0, 2), sha.Substring(2));
var compressed = File.ReadAllBytes(path);
using var input = new MemoryStream(compressed);
using var zlib = new ZlibStream(input, CompressionMode.Decompress);
var raw = new MemoryStream();
zlib.CopyTo(raw);
var bytes = raw.ToArray();
<p>// 查找第一个 \0，前面是 header，后面是 payload
var nullPos = Array.IndexOf(bytes, (byte)0);
if (nullPos == -1) throw new InvalidDataException("no null byte in git object");
var payload = bytes[(nullPos + 1)..]; // C# 8+ range syntax</p>漏掉 <p>漏掉 <code>\0 定位或误判 size 长度会导致 payload 偏移，内容损坏。Windows 上路径大小写不敏感还可能掩盖对象路径拼写错误（如 OBJECTS 被当作 objects）。
size 长度会导致 payload 偏移，内容损坏。Windows 上路径大小写不敏感还可能掩盖对象路径拼写错误（如 OBJECTS 被当作 objects）。
写入新对象时，务必调用 git hash-object 验证或用 LibGit2Sharp 回写
手动构造对象后，若直接写入 .git/objects/，Git 命令行工具（如 git cat-file）可能无法识别，因为：未按两级目录规则存放；未设置正确文件权限（通常是 0444）；未更新 .git/objects/info/packs 或 .git/objects/info/alternates（虽非必需，但影响完整性校验）。更稳妥的做法是用 LibGit2Sharp 的 CreateBlob / CreateTree，或调用外部命令：
var proc = Process.Start(new ProcessStartInfo {
FileName = "git",
Arguments = $"-C \"{repoRoot}\" hash-object -w --stdin",
UseShellExecute = false,
RedirectStandardInput = true,
RedirectStandardOutput = true
});
proc.StandardInput.Write(rawBytes);
proc.StandardInput.Close();
var sha = proc.StandardOutput.ReadToEnd().Trim();
这种混合方式容易受环境变量、git 版本、PATH 影响，CI 环境中尤其不可靠。真正需要稳定集成时，LibGit2Sharp 的 Odb.Write() 是唯一可维护的选择。
Git 对象的 SHA-1 不是简单对文件内容哈希，而是对 {type} {size}\0{content} 整体哈希。漏掉 header 或字节顺序错一个，SHA 就完全不对，后续任何引用都失效。
