本文详解如何使用 git2go 在内存中创建、添加并提交新文件，重点解决“提交后文件显示为 deleted”的常见问题——关键在于调用 CheckoutTree 同步工作目录，而非仅写入索引或树对象。
本文详解如何使用 git2go 在内存中创建、添加并提交新文件，重点解决“提交后文件显示为 deleted”的常见问题——关键在于调用 `checkouttree` 同步工作目录，而非仅写入索引或树对象。
在使用 git2go 进行无磁盘文件操作（即不预先写入物理文件）时，许多开发者会陷入一个典型误区：认为只要调用 index.Write() 和 index.WriteTree() 就能完成“添加+提交+落地”的全流程。然而，正如官方文档与实践所揭示的，Git 的三棵树模型（working directory → index → HEAD）是严格分离的。你成功创建了 blob、构建了 tree、生成了 commit，但工作目录（working directory）仍保持原状——它并不知道新文件已存在，因此 git status 将其标记为 “deleted”（实质是“已从工作区消失，但索引/HEAD 中存在”，即 staged deletion 的反向表现）。
要真正让文件“出现在磁盘上”，必须显式执行 checkout 操作，将新 commit 的 tree 内容应用到工作目录。这对应于命令行中的 git checkout HEAD -- <file></file> 或 git checkout HEAD，在 git2go v25+ 中，应使用 repo.CheckoutTree() 配合合适的 CheckoutOpts。
以下是修复后的完整、生产就绪代码（关键修改已加注）：
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
package main
import (
"fmt"
"gopkg.in/libgit2/git2go.v25"
"time"
)
func main() {
sig := &git.Signature{
Name: "Some Person",
Email: "some.person@example.com",
When: time.Now(),
}
repo, err := git.OpenRepository("./repo")
check(err)
defer repo.Free()
content := []byte("hello world")
// ✅ Step 1: 创建 blob（内容存入对象数据库）
oid, err := repo.CreateBlobFromBuffer(content)
check(err)
// ✅ Step 2: 构建索引条目并添加到暂存区
index, err := repo.Index()
check(err)
defer index.Free()
ie := git.IndexEntry{
Mode: git.FilemodeBlob,
Id: oid,
Path: "documents/document_9.md",
}
err = index.Add(&ie)
check(err)
// ✅ Step 3: 将索引写入磁盘（持久化暂存状态）
err = index.Write()
check(err)
// ✅ Step 4: 从索引生成 tree 对象（写入对象库）
treeId, err := index.WriteTree()
check(err)
tree, err := repo.LookupTree(treeId)
check(err)
defer tree.Free()
// ✅ Step 5: 获取当前 HEAD 指向的 commit（作为父提交）
currentBranch, err := repo.Head()
check(err)
defer currentBranch.Free()
currentTip, err := repo.LookupCommit(currentBranch.Target())
check(err)
defer currentTip.Free()
// ✅ Step 6: 创建新 commit（指向新 tree，父为 currentTip）
commitId, err := repo.CreateCommit("HEAD", sig, sig, "A new commit", tree, currentTip)
check(err)
fmt.Println("New commit created:", commitId.String())
// ⚠️ CRITICAL STEP: 同步工作目录！否则文件仅存在于 commit 中，不在磁盘上
// 使用 CheckoutTree 将新 HEAD 的 tree 应用到工作区
opts := &git.CheckoutOptions{
CheckoutStrategy: git.CheckoutForce | git.CheckoutAllowConflicts | git.CheckoutRemoveUntracked,
}
err = repo.CheckoutTree(tree, opts)
check(err)
fmt.Println("Working directory synced to new commit.")
}
func check(err error) {
if err != nil {
panic(err)
}
}关键说明与注意事项：
-
CheckoutTree是核心：它读取指定 tree，并将其中所有文件内容写入工作目录对应路径。若路径不存在，自动创建父目录（如documents/）；若文件已存在，则覆盖。这是让git status显示 clean 的唯一可靠方式。 -
策略选项（
CheckoutStrategy）建议：-
git.CheckoutForce：强制覆盖工作区文件（必需，否则对已存在路径会失败）； -
git.CheckoutAllowConflicts：允许冲突发生（便于调试）； -
git.CheckoutRemoveUntracked：清理未被新 tree 覆盖的旧文件（可选，避免残留）。
-
-
资源释放：务必对
index、tree、currentBranch、currentTip调用Free()，避免内存泄漏（git2go基于 C，需手动管理）。 -
错误处理增强：生产环境建议使用更精细的错误分类（如区分
git.ErrNotFound），而非统一 panic。 -
替代方案（不推荐）：有人尝试用
git.Reset()回滚再 checkout，但效率低且逻辑冗余；直接CheckoutTree最简洁高效。
执行修复后代码，再次运行 git status，输出将变为：
On branch master nothing to commit, working tree clean
且 ./repo/documents/document_9.md 真实存在，内容为 hello world —— 完整闭环达成。
