Commit(提交/快照)
又稱:提交 · commit message · git commit · 提交訊息 · 快照
一次存檔:把專案在那一刻的樣子整包記下來,附一句說明。
你會在什麼時候遇到它
AI agent 每做完一步通常會 commit 一次,這樣它做壞了你能還原、你也能看出它到底動了哪些檔案。看不懂 commit,你就只能眼睜睜看著 agent 改了一大片,卻分不出哪些是它動的、哪些原本就是你的。
打個比方
像寫作時的「儲存並加註版本」:不是另存一份新檔案塞滿資料夾,而是在同一份文件上蓋一個時間戳,配一句「這裡改了什麼」。
最小範例
git add -A
git commit -m "把 API key 從程式碼移到環境變數"
git log --oneline # 4c380c5 把 API key 從程式碼移到環境變數
git show 4c380c5 # 這一次存檔究竟改了哪幾行commit 訊息是寫給三個月後的你、以及你的隊友看的。理想情況是只看 git log 就能讀出這個專案的歷史,不必打開檔案一個個比對。
最常搞錯的地方
- 訊息寫「update」「fix」「改了一下」。等到你要還原某一次修改時,這種訊息的資訊量是零,等於沒寫。
- 一次 commit 塞進十件不相關的修改。要單獨還原其中一件時就拆不開了;agent 也常常因此把半成品一起存進去。