如何初始化Git测试仓库并解决分支无法通过ForEach迭代的问题？

你遇到的问题核心是空仓库中创建的无关联提交的分支，无法被Branches()方法枚举。go-git的CreateBranch如果只指定分支名、不设置Target（指向的提交哈希），会创建一个仅包含分支引用但无实际提交指向的"空分支"，而Branches()默认只会返回关联了有效提交的分支。但直接调用repo.Branch()是直接查找引用存储中的分支条目，所以能找到。

解决方案 #

要解决这个问题，你需要先给仓库创建一个初始提交，让所有分支都有可指向的提交对象，之后再创建分支，或者在创建分支时显式指定目标提交。同时结合你的需求（创建仓库、分支、在分支创建文件），完整的测试代码流程如下：

func TestCommonSuiteExample(t *testing.T) {
    // 初始化内存仓库和文件系统
    fs := memfs.New()
    storage := memory.NewStorage()
    repo, err := git.Init(storage, fs)
    if err != nil {
        t.Fatal(err)
    }

    // 第一步：创建初始提交（必须，否则分支无指向的提交）
    // 创建一个初始文件
    f, err := fs.Create("initial.txt")
    if err != nil {
        t.Fatal(err)
    }
    f.WriteString("initial content")
    f.Close()

    // 添加到暂存区并提交
    wt, err := repo.Worktree()
    if err != nil {
        t.Fatal(err)
    }
    _, err = wt.Add("initial.txt")
    if err != nil {
        t.Fatal(err)
    }
    commitHash, err := wt.Commit("initial commit", &git.CommitOptions{
        Author: &object.Signature{
            Name:  "Test Author",
            Email: "test@example.com",
            When:  time.Now(),
        },
    })
    if err != nil {
        t.Fatal(err)
    }

    // 获取初始提交的引用，用于分支创建时指定Target
    initialCommit, err := repo.CommitObject(commitHash)
    if err != nil {
        t.Fatal(err)
    }

    // 定义分支列表
    branchNames := []string{
        "refs/heads/JOB-62131/JOB-76475/add-location-timers-to-fms",
        "refs/heads/JOB-62131/JOB-76477/store-feature-enablement",
        "refs/heads/JOB-62131/JOB-77400/show-modal-dialogue-on-disablement",
    }

    // 基于初始提交创建分支
    for _, bName := range branchNames {
        opts := &config.Branch{
            Name:   bName,
            Target: initialCommit.Hash, // 显式指定分支指向的提交
        }
        err := repo.CreateBranch(opts)
        if err != nil {
            t.Fatal(err)
        }
    }

    // 现在可以正常迭代所有分支
    branches, err := repo.Branches()
    if err != nil {
        t.Fatal(err)
    }

    err = branches.ForEach(func(ref *plumbing.Reference) error {
        fmt.Printf("分支名：%s，是否为分支：%t\n", ref.Name().String(), ref.Name().IsBranch())
        return nil
    })
    if err != nil {
        t.Fatal(err)
    }

    // 示例：切换到第一个分支并创建文件
    targetBranch := branchNames[0]
    err = wt.Checkout(&git.CheckoutOptions{
        Branch: plumbing.ReferenceName(targetBranch),
    })
    if err != nil {
        t.Fatal(err)
    }

    // 创建新文件
    newFile, err := fs.Create("location-timers.go")
    if err != nil {
        t.Fatal(err)
    }
    newFile.WriteString("package main\n// timer code")
    newFile.Close()

    // 提交新文件
    _, err = wt.Add("location-timers.go")
    if err != nil {
        t.Fatal(err)
    }
    _, err = wt.Commit("add location timers", &git.CommitOptions{
        Author: &object.Signature{
            Name:  "Test Author",
            Email: "test@example.com",
            When:  time.Now(),
        },
    })
    if err != nil {
        t.Fatal(err)
    }
}

关键说明 #

• 必须先创建初始提交：Git的分支本质是指向提交的引用，空仓库中没有任何提交，创建的分支只是一个孤立的引用，Branches()方法会过滤掉这类无效分支。
• 创建分支时指定Target：确保每个分支都指向一个有效的提交对象，这样就能被Branches()枚举到。
• 操作文件需要通过Worktree：billy文件系统的操作要结合仓库的工作区，修改后需要添加到暂存区并提交才能同步到仓库中。

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