如何使用libgit2在裸Git仓库中提交到指定分支？

我明白你的需求——要做一个基于Git的博客系统，用裸仓库存内容，不想通过本地检出工作区来提交，还要实现类似GitHub在线编辑提交的功能。其实libgit2完全支持这种操作，因为它可以直接操作Git的底层对象（blob、tree、commit），不需要依赖工作区。下面我一步步给你讲清楚怎么做：

核心思路 #

裸仓库本质上就是没有工作目录的Git仓库，所有Git对象（提交、树、blob）都存在objects目录里，分支引用存在refs/heads下。常规Git命令需要工作区是因为它要跟踪文件变更，但libgit2可以直接构建这些对象，然后更新分支引用，全程不用checkout任何内容。

具体步骤（附C语言示例） #

假设你已经安装了libgit2，下面是关键步骤的代码示例，我会逐段解释：

1. 打开裸仓库 #

首先要打开目标裸仓库，用git_repository_open或者git_repository_open_bare都可以，裸仓库的路径就是你用git init --bare创建的那个目录：

git_repository *repo = NULL;
int error = git_repository_open(&repo, "/path/to/your/bare/repo.git");
if (error < 0) {
    const git_error *err = giterr_last();
    fprintf(stderr, "Failed to open repo: %s\n", err->message);
    // 错误处理逻辑
}

2. 创建Blob对象 #

把你的博客内容（比如一篇Markdown文件的内容）转换成Git的blob对象——这相当于git add把文件内容存入仓库：

git_blob *blob = NULL;
const char *content = "# My New Blog Post\n\nThis is the content of my latest post.";
size_t content_len = strlen(content);

error = git_blob_create_from_buffer(&blob, repo, content, content_len);
if (error < 0) {
    // 错误处理逻辑
}

3. 构建Tree对象 #

Git的提交需要一个树（tree）来记录文件的路径和对应的blob。你需要把刚才创建的blob放到对应的路径下（比如posts/2024-05-20-my-post.md）：

git_treebuilder *builder = NULL;
git_oid tree_oid;

// 创建空的tree构建器
error = git_treebuilder_new(&builder, NULL);
if (error < 0) { /* 错误处理 */ }

// 将blob添加到tree的指定路径，权限设为0100644（普通文件权限）
error = git_treebuilder_insert(NULL, builder, "posts/2024-05-20-my-post.md", &git_blob_id(blob), 0100644);
if (error < 0) { /* 错误处理 */ }

// 将构建好的tree写入仓库
error = git_treebuilder_write(&tree_oid, repo, builder);
if (error < 0) { /* 错误处理 */ }

// 释放资源
git_treebuilder_free(builder);
git_blob_free(blob);

4. 创建Commit对象 #

接下来要基于当前分支的HEAD（如果分支存在）作为父提交，创建新的commit对象——这相当于git commit：

git_commit *parent_commit = NULL;
git_oid parent_oid;
git_oid commit_oid;
git_signature *author = NULL;
git_signature *committer = NULL;

// 设置作者和提交者信息
error = git_signature_now(&author, "Your Name", "your.email@example.com");
error = git_signature_now(&committer, "Your Name", "your.email@example.com");

// 获取目标分支的当前HEAD作为父提交（如果分支已存在）
git_reference *branch_ref = NULL;
error = git_reference_lookup(&branch_ref, repo, "refs/heads/main");
if (!error) {
    git_reference_peel((git_object**)&parent_commit, branch_ref, GIT_OBJECT_COMMIT);
    git_reference_free(branch_ref);
}

// 创建commit，同时直接更新指定分支的引用
const char *message = "Add new blog post: 2024-05-20-my-post.md";
error = git_commit_create_v(
    &commit_oid, repo, "refs/heads/main", // 直接指定要更新的分支
    author, committer,
    "UTF-8", message,
    git_tree_lookup(NULL, repo, &tree_oid), // 关联刚才创建的tree
    parent_commit ? 1 : 0, // 父提交数量
    parent_commit ? &parent_oid : NULL // 父提交OID（如果存在）
);

// 释放资源
if (parent_commit) git_commit_free(parent_commit);
git_signature_free(author);
git_signature_free(committer);

5. 清理资源 #

最后别忘了关闭仓库，释放所有libgit2对象：

git_repository_free(repo);

关键细节说明 #

• 如果是第一次向分支提交（分支不存在），git_reference_lookup会失败，这时候父提交数量设为0，直接创建初始提交即可。
• 上述代码在git_commit_create_v里直接指定了分支引用，创建commit后会自动更新分支指针，不需要额外的git_reference_update操作。
• 如果你需要修改已有文件，只需要创建新的blob，更新对应的tree条目，再基于当前分支的HEAD创建新commit即可——和GitHub在线编辑的逻辑完全一致。

其他语言绑定 #

如果你不用C语言，libgit2有很多语言绑定（比如Python的git2-utils、JavaScript的nodegit），它们的API逻辑和C核心是一致的，只是语法不同。比如用Python的话，步骤也是打开仓库、创建blob、构建tree、创建commit、更新分支。

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