虽然 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（较新版本默认显示）或使用：bashgit show <commit-id> -
同步 Note：
Notes 不会自动推送，你需要像推送分支一样操作：
git push origin refs/notes/* git fetch origin refs/notes/*:refs/notes/*
总结建议
-
优先使用 Commit Message： 描述代码变更的核心逻辑应当始终放在 Commit Message 中。
-
慎用 Notes： 除非你需要记录一些与代码逻辑无关、且可能随时间变化的元数据，否则不要依赖 Notes，因为它在团队协作中的可见性（同步成本）比 Commit 低得多。