Git本地分支专属元数据的最优存储方案咨询

你没考虑到的额外方案 #

• Git Notes：可将元数据关联到分支的HEAD提交，默认本地Notes不会推送到远程，完全满足仅本地保留的需求。用git notes add -m "key=value"就能添加，也支持存储JSON这类结构化内容，后续通过git notes show读取即可。如果需要把部分元数据纳入版本控制，还能通过配置或手动推送特定notes refs实现。
• .git目录下的自定义文件：直接在.git目录里创建自定义文件（比如.git/branch-meta），搭配简单脚本读写。.git目录下的非Git原生文件默认不会被追踪或推送，完全本地隔离，适合存储分支与元数据的映射关系。
• 本地扩展Refs：在.git/refs/下创建自定义子目录（比如.git/refs/branch-meta/），为每个分支创建对应文件存储元数据。Git不会自动处理这些自定义refs，因此不会被推送到远程，写入用git update-ref refs/branch-meta/<branch-name> <meta-content>，读取直接查看文件内容即可。

现有方案的问题对比，最优选择是git config --local #

• git config --local：问题最少，最贴合需求。Git本地配置就是为存储仓库专属本地设置设计的，你可以用git config --local branch.<你的分支名>.meta-key meta-value存储分支专属键值对，读取用git config --local branch.<你的分支名>.meta-key，无需额外脚本。如果想纳入版本控制作为安全机制，可把配置片段提取到项目模板文件（比如local-config-template），让用户手动导入，既满足版本追踪，又不污染远程仓库。唯一小局限是复杂结构元数据需拆分成多个键值对，但你提到是少量数据，完全够用。
• Tag方案：问题最多。Tag是全局关联提交的标记，不是分支专属，易和发布版本的tag混淆；默认会推送到远程，不符合仅本地保留要求；分支rebase或移动HEAD时，tag不会跟着移动，元数据会和分支脱离关联。
• 外部JSON文件：缺陷明显。如果纳入版本控制，多人本地元数据会导致频繁冲突；如果不纳入，需手动加进.gitignore，容易误提交，且工作区文件可能被误删或清理，读写还需额外编写脚本，不如Git原生工具便捷。

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