首页/开发/Git 与协作速查/git notes 附加提交注解
进阶与大仓实践69 条

git notes 附加提交注解

在不修改提交内容的前提下给提交挂注解(评审结论、CI 结果、迁移标记);注解存放在独立引用空间,默认不随 push 同步。

Git 与协作速查开发更新于 2026-10-12
常用命令git notes add/show/append/remove/list
引用空间refs/notes/commits(可用 --ref 自定义)
同步git push origin refs/notes/commits 显式推送

常用示例

常用示例
git notes add -m '已通过安全评审' <sha>
git notes show <sha>
git log --show-notes=commits -3
git push origin refs/notes/commits
适合自动化写入构建与扫描结果;对外协作前确认接收方会读取 notes,否则信息形同隐藏。

易错点

  • 忘记推送 notes 引用导致本地可见、远端缺失,协作时出现「信息不一致」
  • 把重要结论只放 notes 而不进提交信息,后来者很容易错过

数据来源与参考

  • Git 官方文档:git-notes
  • Pro Git 2nd Edition · 7.x 说明(notes 引用空间)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌