寫好的 commit 訊息
未來的你會感謝你的訊息
⏱ 預估 ~8 分鐘
01 · 讀一讀
一個好的 commit 訊息，是送給未來的你（跟你隊友）的禮物。它應該解釋你為什麼改，不只是改了什麼。清楚的訊息會讓 git 歷史真的有用。
💡 想像一下寫好的 commit 訊息就像在照片背面標籤。「在阿嬤家辦的 3 歲生日派對」很有幫助。「照片」沒有。幾個月後，這些標籤是你唯一能想起每張快照在拍什麼的方式。
重點整理
- 好的訊息會解釋為什麼:'Fix login timeout for slow connections'
- 差的訊息很模糊：'fixed stuff'、'update'、'asdf'
- 第一行要短（50 個字元內），用祈使語氣：'Add'、'Fix'、'Update'
02 · 終端機練習
你有一個含 HTML 跟 CSS 的部落格專案。我們用完整流程練習寫好的 commit 訊息。
(本節為互動練習，請啟用 JavaScript 體驗)
03 · 終端機練習
把全部檔案 stage 起來，做你的第一個 commit。
(本節為互動練習，請啟用 JavaScript 體驗)
04 · 終端機練習
你的第一個 commit 應該描述這個專案裝了什麼。不要只寫 'first commit' — 要具體說明你的起點是什麼。
(本節為互動練習，請啟用 JavaScript 體驗)
05 · 選擇題
下面哪個 commit 訊息符合最佳實踐？
- "fixed stuff"
- "Add user login validation for email format"
- "update"
- "changes"
06 · 終端機練習
現在來幫你的部落格加一個新功能 — 一個導覽列。
(本節為互動練習，請啟用 JavaScript 體驗)
07 · 終端機練習
Stage 改過的檔案。
(本節為互動練習，請啟用 JavaScript 體驗)
08 · 終端機練習
為這個改動寫一個 commit 訊息。描述你加了什麼，不要只寫 'update'。好的範例：'Add navigation bar to blog'、'Add nav links for Home, About, Contact'。
(本節為互動練習，請啟用 JavaScript 體驗)
09 · 選擇題
下面哪個 commit 訊息最符合專業慣例？
- "updated stuff"
- "asdfjkl"
- "Fix password reset for expired tokens"
- "I changed the login page to fix a bug where users couldn't log in when their session expired after 24 hours"
⚠ 完整互動體驗需要 JavaScript。請啟用 JavaScript 後重新整理。
※ 本站為獨立繁中教學專案，非 Anthropic 官方產品。Claude™ 為 Anthropic, PBC 商標。