Git 附註：Git 最酷卻又最被忽略的功能 (2022) （★
81 分）
Git notes 是 Git 中一項鮮為人知卻具潛力的功能，能在不更動原有提交物件的前提下，為 commit、新增 blob 或 tree 附加元資料。透過指令 git notes add -m，使用者可以在提交歷史中新增附註，而這些附註會以獨立命名空間的方式儲存，而非直接編輯提交本身。Git 原生亦採用此功能，例如將每筆提交與其在討論郵件串中的連結對應起來，展示了 git notes 在記錄額外背景資訊上的彈性與優勢。
文章進一步介紹了 git notes 的多元應用，包括追蹤每筆提交所屬票券、記錄審查或測試結果，甚至可作為實現完全分散式代碼審查的基礎。例如，Gerrit 外掛 reviewnotes 能使開發者在不打開瀏覽器的情況下，直接在本機端透過 git log 檢視審查與測試資訊；而 Google 所推出的 git-appraise 更是示範了如何借鏡此功能打造一個獨立於 GitHub 或 GitLab 的分散式代碼審查系統。
然而，儘管技術上無可挑剔，git notes 的使用體驗卻因介面生硬且操作複雜而大打折扣。文章中指出，雖然可以透過調整 gitconfig 選項改善提交附註在 log 中的呈現，但對於針對 blob 或 tree 的附註操作則需要深入理解 Git 的內部機制，這使得大多數開發者反而選擇忽略這項功能。GitHub 甚至在 2014 年選擇不再預設顯示提交附註，進一步影響了其普及度。
討論區的回應則呈現出兩極分化的觀點。有使用者驚訝於自己在多年使用 Git 後才發現此功能，並分享了在工作中利用 git notes 記錄內部代碼審查、票券對應及故障追蹤的實際體驗，認為這種做法能減少在 Slack 或 Jira 等其他平台上搜尋紀錄的麻煩。也有意見指出商業平台似 GitHub 為了維護自身附加價值，可能不會主動推廣將元資料內嵌於 Git 中的做法；此外，部分討論者也提及 PostgreSQL 的 COMMENT 與 git trailers 等類似功能，暗示市場上對嵌入式元資料的需求與探索仍在持續。
綜合而言，git notes 展現了為版本控制提供更豐富元資料管理的潛力，能夠突破傳統依賴第三方平台的限制，實現更分散且離線的協作方式。未來若能改善其操作介面與整合性，這項功能或許將為程式碼歷史記錄與代碼審查開創全新局面，成為推動分散式開發的一大利器。
👥
17 則討論、評論 💬
https://news.ycombinator.com/item?id=44345334