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 分支)。老闆突然說要加一個新功能。

你可以:

  1. 開一個新分支:feature/shopping-cart(存個檔,走另一條路線)
  2. 在新分支上開發:新 commit 先留在這條分支,不會直接加入主線
  3. 開發完成後合併回主線:新功能測試 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 一次,讓每份紀錄的改動比較集中。等到一整天的工作都寫完才存,出問題時就比較難找回中間的進度。


延伸閱讀:


站內相關文章: