go-git中实现与`git branch <branchname>`等效的本地分支创建正确方法

你之前对三类实现路径的源码级排查完全准确，go-git 当前没有提供开箱即用的、完全匹配原生无参数git branch <branchname>行为的内置方法，不存在未被你排查到的隐藏实现，但可以通过手动组合现有能力1:1对齐原生执行效果。

排查结论验证 #

• 对Repository.CreateBranch的判断没有偏差：该方法设计定位就是修改.git/config文件，为分支添加远程跟踪配置段，既不会写入实际的refs/heads/<分支名>引用，也无其他文件系统副作用，用于纯本地分支创建属于完全错配，这也是很多旧教程的常见误导点。
• 对Worktree.Checkout配CheckoutOptions.Create=true的风险判断完全正确：该路径核心目标是切换工作区到新分支，默认会清空未跟踪文件、不保留本地未提交改动、不会生成分支reflog，和原生“不切换工作区、保留所有本地状态”的行为冲突，无法用于纯分支创建场景。
• 对storer.ReferenceStorer的能力边界排查没有疏漏：go-git 内置的内存、文件系统两类Storer实现中，所有带“log”命名的接口都指向提交历史遍历逻辑，从设计之初就没有内置reflog的持久化读写能力，不会在写入分支引用时联动生成对应reflog条目。

1:1对齐原生行为的落地步骤 #

完全按照原生git的执行逻辑，分两步实现，最终效果和CLI执行无差异：

1. 创建分支引用
   先通过仓库对象拿到当前HEAD解引用后的实际提交哈希，调用ReferenceStorer的SetReference方法，创建指向该哈希的正式分支引用，引用路径严格使用refs/heads/<分支名>，和原生git的refs存储规则完全一致。
2. 写入配套的分支reflog
   原生不带start-point的git branch <name>，在logs/refs/heads/<分支名>路径下生成的首条reflog条目格式固定，按格式直接写入即可：

   条目格式：0000000000000000000000000000000000000000 <当前HEAD的提交哈希> <仓库配置读取的user.name> <仓库配置读取的user.email> <操作时间（带时区偏移）> branch: Created from HEAD

   • 使用go-git默认文件系统Storer时，可直接在仓库的.git目录下定位logs/refs/heads/路径，新建对应分支名的日志文件，写入上述格式的首行条目即可
   • 细节校验要求：旧值必须是连续40个0的空提交哈希、提交者信息必须从仓库配置中读取、时间格式和原生git日志格式保持一致，避免出现reflog解析失败

常见踩坑点 #

• 不要尝试调用go-git中带Reflog关键字的内置方法，当前版本这类方法绝大多数是空实现或仅支持读取提交日志，无写入reflog的能力
• 实现完成后可用原生git命令做校验：执行git branch -v能正常展示新分支、git reflog show <分支名>能看到对应创建记录，即说明完全对齐原生行为
• 不需要引入第三方reflog实现依赖，只要严格按照固定格式写入条目，完全可以匹配git的解析规则

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