在 Git2go 中调用 AddAll() 修改索引后未持久化到磁盘，会导致 git status 错误地将已提交文件标记为“已删除”，需显式调用 index.Write() 保存索引状态。
在 git2go 中调用 `addall()` 修改索引后未持久化到磁盘，会导致 `git status` 错误地将已提交文件标记为“已删除”，需显式调用 `index.write()` 保存索引状态。
该问题本质源于对 libgit2（Git2go 底层库）索引（index）工作模式的误解：git2go.Index 是一个内存中的暂存区数据结构，AddAll() 仅修改内存索引，不会自动写回 .git/index 文件。因此，尽管你成功创建了 commit 并推送，但工作目录的索引状态仍处于“未提交变更”的中间态——所有被 AddAll([]string{}, ...) 扫描到的文件（尤其是 .gitignore 及其所在目录）因未被显式 git add 过，在索引中缺失对应条目，git status 就将其识别为“已删除”（deleted），而实际文件仍存在于磁盘，故同时归类为“未跟踪文件”（untracked）。
正确的流程：三步必须闭环
- 读取索引 → 2. 修改索引（如 AddAll） → 3. 写回磁盘（关键！）
修正后的核心代码如下（含必要错误处理与逻辑顺序）：
// 1. 打开仓库与索引
repo, err := git.OpenRepository(dir)
if err != nil {
log.Fatal("无法打开仓库:", err)
}
defer repo.Free()
index, err := repo.Index()
if err != nil {
log.Fatal("无法获取索引:", err)
}
defer index.Free()
// 2. 添加所有文件到索引（递归扫描工作目录）
// 注意：AddAll 第二个参数为标志位，git.IndexAddDefault = 0，等价于 git add .
err = index.AddAll([]string{"."}, git.IndexAddDefault, nil)
if err != nil {
log.Fatal("添加文件失败:", err)
}
// ✅ 关键修复：将修改后的索引写入磁盘，同步 .git/index 文件
err = index.Write()
if err != nil {
log.Fatal("写入索引失败:", err)
}
// 3. 创建树对象（基于已持久化的索引）
treeId, err := index.WriteTreeTo(repo)
if err != nil {
log.Fatal("写入树对象失败:", err)
}
tree, err := repo.LookupTree(treeId)
if err != nil {
log.Fatal("查找树对象失败:", err)
}
defer tree.Free()
// 4. 创建提交（HEAD 指向新提交）
sig := &git.Signature{
Name: userName,
Email: userName + "@" + beego.AppConfig.String("userdata::emailserver"),
When: time.Now(),
}
commitId, err := repo.CreateCommit("HEAD", sig, sig, message, tree)
if err != nil {
log.Fatal("创建提交失败:", err)
}
defer commitId.Free()
// 5. 推送（可选，但需确保远程存在）
remote, err := repo.LookupRemote("origin")
if err != nil {
log.Fatal("查找远程失败:", err)
}
defer remote.Free()
err = remote.Push([]string{"refs/heads/master"}, nil, sig, message)
if err != nil {
log.Fatal("推送失败:", err)
}
注意事项与最佳实践
- AddAll 的路径参数：原代码传入 []string{}（空切片）导致 AddAll 扫描整个工作目录但不匹配任何路径，行为不可靠。应明确指定 []string{"."} 或具体子目录，确保覆盖目标文件。
- 资源释放：git2go 对象（如 repo, index, tree, commitId, remote）需显式调用 Free() 避免内存泄漏，示例中已标注。
- 索引与工作目录一致性：index.Write() 仅更新 .git/index，不影响工作目录文件。若需重置工作目录状态（如模拟 git reset --hard），需额外调用 repo.Reset()。
- 调试技巧：执行后运行 git ls-files --stage 可验证索引中是否包含预期文件条目；git status --porcelain 更便于程序化判断状态。
遵循此流程，git status 将正确显示 nothing to commit, working tree clean，彻底解决“文件被标记为已删除”的误报问题。
