git notes
虽然git commit和git notes都与提交信息有关，但它们的设计初衷和存储方式有着本质的区别。简单来说：Commit 是历史的“骨架”，而 Note 是贴在骨架上的“便利贴”。
以下是它们的详细对比：
1. 核心定义与永久性
Git Commit（提交）：
它是 Git 的基本组成单元。每个 Commit 包含指向树对象的指针、作者信息、时间戳以及提交说明（Commit Message）。
不可变性：一旦生成，Commit 的任何内容（包括消息）都不能直接修改。如果要改，就会生成一个新的 Commit ID（哈希值），这会改变项目历史。
Git Notes（附注）：
它允许你为现有的 Commit 附加额外的信息，而无需修改 Commit 本身。
灵活性：你可以在不改变 Commit ID 的情况下，随时添加、删除或更新 Note。
2. 关键区别对比表
| 特性 | Git Commit Message | Git Notes |
| 修改后果 | 会改变 Commit ID，破坏历史连续性 | 不改变 Commit ID，对现有历史无影响 |
| 存储位置 | 直接包含在 Commit 对象中 | 存储在独立的引用中（通常是refs/notes/commits） |
| 主要用途 | 记录代码变更的原因和逻辑 | 添加元数据、代码评审意见、构建状态等 |
| 传输行为 | 默认随git push/pull同步 | 默认不同步（需显式推送refs/notes/*） |
| 可见性 | git log默认显示 | 需git log --show-notes或配置后显示 |
3. Git Notes 的典型应用场景
因为 Notes 不破坏哈希值的特性，它通常用于以下“补充说明”的场景：
持续集成 (CI/CD)：自动将测试结果、构建编号或部署链接附加到对应的提交上。
代码评审：在不重新提交代码的情况下，将评审者的意见记录在对应的 Commit 上。
修正信息：如果发现某个旧的提交信息写错了，但代码已经推送到公共分支无法
amend，可以用 Note 补上一句说明。Bug 追踪：将 Bug 数据库中的工单链接关联到代码提交。
4. 常用操作指令
添加/编辑 Note：
git notes add -m "这是一条附加说明" <commit-id>查看 Note：
直接运行
git log（较新版本默认显示）或使用：git show <commit-id>同步 Note：
Notes 不会自动推送，你需要像推送分支一样操作：
git push origin refs/notes/* git fetch origin refs/notes/*:refs/notes/*
总结建议
优先使用 Commit Message：描述代码变更的核心逻辑应当始终放在 Commit Message 中。
慎用 Notes：除非你需要记录一些与代码逻辑无关、且可能随时间变化的元数据，否则不要依赖 Notes，因为它在团队协作中的可见性（同步成本）比 Commit 低得多。