Git 版本控制入門 — 用遊戲存檔來理解版本管理
Git 就像遊戲存檔一樣,幫你記錄程式碼的每一個進度。本文用 RPG 遊戲的比喻介紹 Commit、Branch、Merge 等核心概念。
本篇目錄
玩 RPG 時,在打大魔王前先存檔,輸了就能回到那個進度,不用從頭開始。Git 也有類似的用途:記錄程式碼的狀態,方便查看歷史或回到之前的版本。
為什麼需要版本控制?
在學 Git 之前,先來想想沒有版本控制會發生什麼事。
沒有 Git 的世界
假設你在寫一份報告,可能會這樣命名檔案:
報告.docx
報告_修改版.docx
報告_最終版.docx
報告_最終版2.docx
報告_真的最終版.docx
報告_老闆改完版_final_v3.docx
這些檔名很容易讓人搞不清楚哪份才是最新版,也看不出每一版改了什麼。
有 Git 的世界
有了 Git,你只需要一個檔案。每次你做了修改覺得滿意,就「存一個檔」(在 Git 裡叫做 commit)。Git 會自動幫你記錄:
- 什麼時候存的
- 改了什麼東西
- 誰改的
- 為什麼改(你留的備註)
想回到之前的版本?隨時可以「讀檔」回去。
Git 的核心概念 — 用遊戲來比喻
| 遊戲概念 | Git 的概念 | 說明 |
|---|---|---|
| 存檔 | Commit | 記錄當前的程式碼狀態 |
| 讀取存檔 | Checkout / Reset | 回到之前某個版本 |
| 存檔列表 | Log | 查看存檔記錄 |
| 不同路線的存檔分支 | Branch | 在不影響主線的情況下嘗試新東西 |
| 合併多條故事線 | Merge | 把分支的修改合回主線 |
| 雲端同步存檔 | Push / Pull | 把存檔上傳到雲端 / 從雲端下載 |
| 多人連線遊戲存檔 | Remote Repository | 大家共用的雲端存檔空間 |
Commit — 遊戲存檔
Commit 是 Git 最核心的操作。每次 commit 就像按下遊戲的「存檔」按鈕。
一次 commit 包含什麼?
commit a1b2c3d
Author: Aaron <aaron@example.com>
Date: 2026-02-07
feat: 新增會員登入功能
- commit ID(
a1b2c3d):每個存檔的唯一編號 - Author:誰做的修改
- Date:什麼時候存的
- 訊息:這次改了什麼(你自己寫的備註)
好的 commit 訊息很重要
就像遊戲存檔時你會寫備註「打完森林 Boss 了」或「拿到傳說裝備」,commit 訊息也應該清楚說明你做了什麼:
✅ 好的 commit 訊息:
feat: 新增購物車功能
fix: 修正登入頁面密碼驗證錯誤
style: 調整首頁 Banner 間距
❌ 不好的 commit 訊息:
update
修改
asdfgh
Branch — 不同路線的存檔
玩 RPG 的時候,你可能會在選擇劇情分歧前先存個檔,然後分別嘗試不同路線。
Git 的 Branch(分支) 就是這個概念!
一個常見的使用情境
假設你的網站目前運作正常(主線劇情 = main 分支)。老闆突然說要加一個新功能。
你可以:
- 開一個新分支:
feature/shopping-cart(存個檔,走另一條路線) - 在新分支上開發:新 commit 先留在這條分支,不會直接加入主線
- 開發完成後合併回主線:新功能測試 OK,就把這條路線的進度合回去
main: A --- B --- C --------- F
\ /
feature: D --- E
圖中的 F 是合併時產生的 commit。如果開分支之後 main 一直沒有新的 commit,git merge 預設會直接把 main 移到 E(稱為 fast-forward),不會產生 F;想留下 F,可以用 git merge --no-ff,GitHub 預設的「Merge pull request」也是用這種方式合併。如果 main 在這段期間也有新的 commit,就沒辦法 fast-forward,git merge 會產生像 F 這樣的合併 commit。
這樣做的好處是:
- 搭配測試和審查,可以在合併前確認新功能是否適合進主線
- 可以先在分支上嘗試,確認後再決定要不要合併
- 多個人可以同時在不同分支上開發
切換分支前,也要留意還沒 commit 的修改。它們不一定會留在原分支,可能被帶到另一條分支,或讓 Git 拒絕切換;先查看狀態,再決定要提交或暫存。
常用的 Git 指令
先記住日常會用到的幾個指令,可以把它們對應到遊戲裡的操作:
開始新遊戲
git init -b main
在目前的資料夾建立一個新的 Git 儲存庫。就像開始一場新遊戲。
-b main 是指定主線分支叫 main。省略時會依 Git 的預設設定命名,可能是 master 或其他名稱;這裡明確指定,才和後續的 main 指令一致。如果 Git 版本太舊不支援 -b,可以先跑 git init,建立第一個 commit 後再用 git branch -M main 改名。
查看目前狀態
git status
看看有哪些檔案被修改了但還沒存檔。就像打開遊戲選單確認目前的進度。
選擇要存檔的內容
git add index.html
git add . # 全部都加
告訴 Git「這些修改我要存」。就像你在存檔前選擇「要存哪些進度」。
實際存檔
git commit -m "feat: 新增首頁"
把剛才 add 的修改正式存檔。-m 後面是存檔的備註。
查看存檔記錄
git log
看目前這條路線的歷史存檔,從最新的開始列出。想連其他分支一起看,可以用 git log --all --oneline --graph。
開一條新的路線
git switch -c feature/dark-mode
從目前的進度分岔出一條新路線,並且直接切過去。就像前面說的「存個檔,走另一條路線」。想切回主線就用 git switch main,想看有哪些路線就用 git branch。
把新路線合回主線
git switch main
git merge feature/dark-mode
先回到主線,再把剛才那條路線的成果併進來。如果兩邊改到同一個地方,Git 會停下來要你決定保留哪一版,這就是所謂的「衝突(conflict)」。
連結雲端存檔空間
git remote add origin https://github.com/你的帳號/你的專案.git
告訴 Git「我的雲端存檔要放在這裡」。這個步驟每個專案只要做一次;如果專案是用 git clone 從 GitHub 抓下來的,Git 已經自動設定好了,可以跳過。
上傳存檔到雲端
git push -u origin main
把你的存檔同步到遠端(GitHub)。就像把遊戲存檔上傳到雲端。-u 只有第一次要加,之後直接 git push 就好。
從雲端下載最新存檔
git pull
git pull 會先抓取遠端進度,再依設定用 merge 或 rebase 整合到目前分支。可以把它想成先下載雲端存檔,再和本機進度整合。如果本機和遠端都有新的 commit,又沒有設定整合方式,現行的 Git 會停下來,顯示錯誤訊息「Need to specify how to reconcile divergent branches」。這時可以用 git pull --no-rebase(merge)或 git pull --rebase 指定做法,也可以先用 git config pull.rebase false(或 true)設定預設值。
GitHub — 雲端存檔空間
你可能聽過 GitHub。它跟 Git 有什麼關係?
簡單說:
- Git = 存檔系統本身(軟體工具)
- GitHub = 雲端存檔空間(線上服務平台)
Git 是在你自己的電腦上運作的。但如果你想要:
- 在不同電腦之間同步程式碼
- 跟其他人一起寫程式
- 有個備份避免電腦壞掉資料遺失
你就需要一個「雲端空間」來存放你的程式碼。GitHub 就是最受歡迎的選擇之一(其他還有 GitLab、Bitbucket 等)。
我自己每天的工作流程就是:在本機用 Git 存檔 → git push 上傳到 GitHub → 同事 git pull 下載最新的程式碼 → 繼續開發。就像大家在玩同一個多人連線遊戲,共用同一份存檔。
常見問題 Q&A
Q:Git 跟 GitHub 有什麼差別?
Git 是工具(像 Word),GitHub 是平台(像 Google Drive)。你用 Git 做版本控制,用 GitHub 來存放和分享你的 Git 儲存庫。
Q:我不是工程師,也需要學 Git 嗎?
如果你會寫任何需要版本管理的檔案(程式碼、文件、設定檔),Git 都很有用。很多設計師、作家也在用 Git 管理他們的作品。
Q:一定要用命令列嗎?有沒有圖形介面?
有的!很多工具提供 Git 的圖形介面,像是:
- VS Code 內建的 Git 功能(非常好用)
- GitHub Desktop(免費、簡單、適合新手)
- Sourcetree(功能完整)
一開始用圖形介面完全沒問題,等熟悉了概念之後,再慢慢學命令列,效率會更高。
Q:commit 要多頻繁?
沒有標準答案,一般可以在完成一個小功能後 commit 一次,讓每份紀錄的改動比較集中。等到一整天的工作都寫完才存,出問題時就比較難找回中間的進度。
延伸閱讀:
站內相關文章: