← 回找觀念
觀念總論|AI 協作方法

第 21 篇|Vibe Coder 必學的 Git 基礎:建立存檔點(Commit)與一鍵還原(Restore/Revert)

不用死背終端機指令,但要分清 Commit 存檔、Restore 丟掉未提交修改、Revert 用新提交抵消舊提交。

2026-07-29 · 作者整理:Lucas · 資安審稿後整理
資安審稿註記:本文已把「保證安全」「最強防線」等過度承諾改成保守表述;凡涉及金鑰、權限、刪除、提交、外部發送與自動化執行,均保留人工確認、沙盒或測試環境前提。

在使用 Claude 或 Cursor 等 AI 協作工具進行「野路子開發(Vibe Coding)」時,非技術背景的讀者最常遇到的尷尬狀況,就是 AI 突然拋出一些聽起來像外星文的術語,例如問你:「要不要 commit 存檔?」、「要不要開個分支?」1。這些專有名詞常讓新手感到心慌意亂,甚至因為害怕弄壞專案而不敢繼續操作。

事實上,這些術語背後指向同一個核心工具——Git。在 AI 時代,你不需要死背艱澀的終端機指令,但你必須搞懂 Git 與雲端 GitHub 的基本觀念,並學會將它們當成你與 AI 協作時的「遊戲存檔安全網」1,。

Git 安全網三件事

Commit

建立本機安全存檔點。

Restore

把未提交的改壞內容拉回來。

Revert

用新提交抵消已提交的錯誤。

實戰步驟一:手動遊戲存檔點——用 Commit 封存本機的完美狀態

首先,我們必須分清 Git(本機端)與 GitHub(雲端)的本質差別:Git 是在你的電腦本機管理檔案版本的工具,而 GitHub 則是存放這些版本的雲端 Google Drive。

當 AI 幫你寫好一段能順利運作的程式碼(例如做好了登入頁面)時,請立刻建立一個存檔點:

建立 Commit(本機存檔點):你可以把 commit 理解為玩遊戲打魔王前的「手動存檔」3。這個動作會在本機幫目前的程式狀態建立一個絕對安全的備份快照。一旦做了 commit,這份完美的狀態就被永久封存了。不論 AI 接下來怎麼發瘋、把你後續的程式碼改得亂七八糟,你都能瞬間還原回這個完美狀態。

上傳雲端與防護過濾:當你在本機存好檔後,使用 push 指令才能把進度正式推送並上傳到雲端的 GitHub 倉庫。但在執行 push 之前,務必建立一個 .gitignore 檔案。這個檔案的作用是告訴 Git,哪些敏感檔案(例如用來串接金流、含有 API 金鑰或密碼的 .env 檔案)「絕對不能追蹤,也絕對不能上傳」。API 金鑰就像你家大門鑰匙,一旦跟著程式碼一起 push 上雲端公開,極易被有心人士盜用刷爆,這是一旦發生就無法挽回的「死罪」,必須用 .gitignore 事先徹底封殺。

實戰步驟二:AI 改壞時的時光倒流——用 Restore 與 Revert 完美救回

在與 AI 密集的協作中,AI 把程式改壞、導致系統徹底崩潰是天天都在發生的日常。遇到這種情況,千萬不要慌張,更不需要肉眼去逐行找 bug,直接對 AI 下達「一鍵讀檔」的指令即可:

還沒 Commit 前:使用 Restore 一鍵重來:如果 AI 剛剛幫你修改了一大堆檔案,你一執行發現完全壞掉,而這批修改還沒有存成 commit。這時直接對 AI 說:「剛才的修改我不要了,幫我 restore 回上一步」。系統會執行 restore 指令,瞬間抹除剛才所有未存檔的混亂變動,當作 AI 剛剛發瘋的事完全沒發生過,直接回到上一次存檔的乾淨起點。

已經 Commit 後:使用 Revert 安全抵消:如果你已經按下 commit 存檔了,才驚覺這一版程式根本是錯的。這時請叫 AI 執行 revert。Revert 的奧妙在於它不會粗暴地抹去你的歷史記錄,而是自動產生一個「反向的 commit」,把剛才那次 commit 的錯誤改動完美抵消掉。這在團隊協作中極度安全,因為每個人都能在 Git 歷史中看見「寫錯、然後被反向抵消」的完整透明過程,絕不會有進度憑空消失的懸案。

← 看更多觀念總論
取得 AI 實戰工具與更新

之後會不定期整理:新方法、指令包(Prompt Pack)、Checklist 與模板。免費、無廣告;正式寄送前會先寄確認信,隨時可來信要求刪除。