Git Notes：Git 最酷却最被忽视的功能
作者：Tyler Cipriani｜翻译：萝卜｜原文链接见文末
![[Pasted image 20250624111333.png]]
你可能已经很熟悉 Git，但你知道 Git 里还有一个几乎被遗忘的宝藏功能——Git Notes 吗？
它是 Git 的隐藏技能之一：允许你在不修改提交历史的情况下，为任意提交添加附加说明。是的，你没听错，不需要 rebase、不需要 --amend，还能保留原始提交记录，简直优雅到极致。
一、Git Notes 是什么？
Git Notes 是一种特殊的机制，允许你向任意 Git 提交附加额外的信息，这些信息不会改变提交本身的内容或 hash。
用法很简单，例如你想在某个提交上加个备注：
|
|
![[Pasted image 20250624104717.png]]
Git 会把这段说明保存到 .git/notes/ 目录中一个单独的对象里，而不是修改提交对象本身。
查看备注也很直观：
|
|
二、为什么不用 git commit --amend 或 git rebase？
这些命令确实能改提交信息，但会改变提交的 hash。而在多人协作的项目里，篡改历史可能会带来混乱甚至灾难。
而 Git Notes 完美避开了这个问题：它们是“附加的”，不是“修改的”。你可以随时添加、更新或删除 Notes，而不会破坏任何引用或分支。
三、Git Notes 能干嘛？
作者举了几个实际场景：
1. 给旧提交加注解
比如你发现某个 3 个月前的提交导致了 bug，但又不想改动原来的历史，就可以用 notes 标注一下：
|
|
2. 自动生成 CI 备注
在 CI 系统中，我们常会为某些提交打上构建状态或元信息。通过 Git Notes，你可以把构建 ID、测试状态等数据挂载在提交上。
比如：
|
|
3. 存储自动化脚本的上下文
在部署或测试系统中，可能需要记录某个提交部署到了哪里、什么时候回滚等信息。Git Notes 可以用作这种“轻量级元数据仓库”。
四、和 GitHub 一起用呢？
GitHub 默认不会展示 Notes（它们存在于 refs/notes/ 命名空间下）。但这并不意味着你不能共享 Notes！
你可以将 Notes 推送到远端：
|
|
并让其他人拉取：
|
|
如果你想所有人都能在 git log 时看到 Notes，可以设置：
|
|
五、Git Notes 的一些注意事项
-
Notes 本质上是 Git 对象，支持多种编辑方式。
-
它们可以像 commit 一样被合并（用
git notes merge）。 -
你可以为 Notes 创建自定义命名空间，用于区分不同用途。
-
默认 Notes 存在于
refs/notes/commits。
六、总结：最被忽视的 Git 超能力
Git Notes 不是每天都用得上，但当你需要时，它可以优雅地解决一堆难题。
它能帮你：
-
注释过去的提交
-
不影响 hash 地补充信息
-
给 CI/CD 系统加点“记忆力”
-
避免滥用 rebase 和 amend
所以，下次你想说点什么，却不想动历史时，试试 Git Notes 吧。
🔗 原文链接：
https://tylercipriani.com/blog/2022/11/19/git-notes-gits-coolest-most-unloved-feature
📬 公众号首发，欢迎转发、关注与留言交流。
需要我为这篇文章加上封面图 prompt 或 SEO 标题吗？