第13章：備份與分享

Git 與 GitHub，把程式碼存檔、備份到雲端，並安全地分享

← 返回課程 開始閱讀 ↓
1

先分清楚：Git 和 GitHub 不是同一個東西

這一章學怎麼把程式碼「存檔」並「備份到雲端」。這兩個名字很像，初學者常搞混。一句話分清楚：

本機
Git ＝ 你電腦上的「存檔系統」

像遊戲的存檔功能，記錄你每一次的進度。也像相機裡的記憶卡，照片先存在本機。

它在你自己的電腦上運作，記錄程式碼的每一個版本。
雲端
GitHub ＝ 網路上的「雲端倉庫」

像把存檔上傳到雲端，做備份、也方便分享。像 Google 相簿，把記憶卡裡的照片上傳雲端。

它在網路上，讓你的程式碼有一份雲端備份，還能分享給別人。
一句話記住

Git 是相機裡的記憶卡（本機存照片）；GitHub 是 Google 相簿（上傳雲端備份、可分享）。 兩者搭配使用。

沒有 GitHub 帳號，也能用 Git 嗎？

可以。Git 是裝在你電腦上的程式，不用註冊、不用網路，照樣能存檔（commit）、看歷史、回到任何一個舊版本。只有當你想要「雲端備份、分享、或讓網站上線」時，才需要 GitHub 帳號。簡單說：Git 自己就很有用，GitHub 是想上雲端時才加的。

本章學習目標

① 分清楚 Git（本機存檔）與 GitHub（雲端倉庫）；
② 學會三個核心詞：commit（存檔點）、push（上傳）、repo（專案資料夾）；
③ 會看版本紀錄、挑一個舊版本還原，也就是 Git 的「時光機」；
④ 養成 push 前一定先做的「安全檢查」習慣；
⑤ 理解 private 與 public 的差別，以及為何 public 也不可怕。

2

兩個核心動作：commit 與 push

用 Git 管理程式碼，最常用的就兩個動作。

commit（提交）＝ 建立一個存檔點

每當你完成一個段落（例如「加了一個新功能」），就 commit 一次，等於在遊戲裡按下「存檔」。每個 commit 還可以附一句說明（例如「新增上傳功能」），方便日後回顧「我那次改了什麼」。比喻：像寫日記，每篇都記下今天做了什麼。

push（推送）＝ 把本機存檔上傳到雲端

commit 只是存在你自己電腦上。要備份到 GitHub（雲端倉庫），就要 push。比喻：把相機記憶卡裡的照片，上傳到 Google 相簿。

commit 真正的威力：能「回到過去」

commit 不只是記錄，它是可以隨時跳回去的存檔點。哪天改一改把程式弄壞了，只要之前有 commit，就能還原到那個好好的版本，不用怕。

那什麼時候該 commit？做好一個小功能、修掉一個問題、或要動一個沒把握的大改「之前」，都各存一次；今天告一段落、要關電腦前也存一次。存得越勤，能回去的存檔點越多，你就越敢放手嘗試。

還有一個常見詞：repo

儲存庫repository（儲存庫，簡稱 repo）就是一個專案在 GitHub 上的對應「資料夾」，裡面放這個專案的所有程式碼與版本歷史。（repository，簡稱 repo）＝ 一個專案在 GitHub 上的「資料夾」。你每個專案，在 GitHub 上都有一個對應的 repo。本課專案的 repo 就叫 SPEC-AUTO-GRADER。

3

回到舊版本：Git 的「時光機」怎麼用

存了一堆 commit 存檔點，真正派上用場的時候，就是「改壞了，想回到某一個好好的版本」。要做這件事，就三步：看紀錄、挑一個、還原。

1 · 看版本紀錄 → 2 · 挑一個版本 → 3 · 還原

① 去哪看版本紀錄？ 最簡單，直接問 AI：「幫我列出這個專案的版本紀錄技術上叫 commit history（提交歷史），就是你所有存檔點由新到舊排成的一串清單，每一筆有說明和時間。」，它就會列出一串存檔點，每一筆都有你當初寫的說明和時間。在 VS Code 裡也看得到：左側的「原始檔控制」面板，或對著檔案打開「時間軸（Timeline）」，都會顯示一條由新到舊的版本清單。

② 怎麼挑哪一個版本？ 對著清單看每一筆的「說明」和「時間」，找出「最後一次還正常」的那一版。這就是當初好好寫 commit 說明的回報：說明寫得清楚（例如「上傳功能正常」），你現在一眼就挑得到；要是每次都只寫「改了東西」，現在就只能瞎猜。

③ 怎麼回到那一版？ 對初學者最穩的做法：把挑好的版本告訴 AI，例如「我想回到『新增上傳功能』那一版」，請它幫你還原、處理細節。一個關鍵的安全動作：回去之前，先把現在的進度也 commit 一次，這樣新、舊兩個版本都還留著、都能再切換，怎樣都不會弄丟。

心法

看得懂版本清單、挑得出對的那一版，比背任何指令都重要。而清單好不好讀，全看你 commit 說明寫得好不好，這正是前面一直強調「附一句清楚說明」的原因。

4

上傳前一定要做的事：安全檢查

還記得第 12 章的教訓嗎？最怕的就是把藏著金鑰的保險箱 .env.local 不小心 push 上去。 所以在真正上傳前，要做一個安全檢查，確認「即將上傳的檔案清單裡，沒有任何機密檔案」。比喻：行李打包好、要寄出去之前，先開箱檢查一遍，「保險箱有沒有不小心被裝進去？」確認沒有，才封箱寄出。

開箱檢查清單：請工具列出「這次會上傳哪些檔案」，然後確認
程式碼、設定檔、說明文件 → 該上傳的，有。
空白範本 .env.local.example → 可以公開，有它沒問題。
真正的保險箱 .env.local → 確認不在清單裡（被 .gitignore 擋住了）。
那一大包下載來的「建材」node_modules → 也不該上傳（別人自己 npm install 就有了）。
心法

push 前一定要瞄一眼「我到底要上傳什麼」。 養成這個習慣，就能避開「金鑰外洩」這個最常見也最痛的意外。

5

private（私有）與 public（公開）

在 GitHub 建立 repo 時，可以選兩種。

Private（私有）

只有你（和你授權的人）看得到。本課專案一開始就設為 private。

Public（公開）

全世界都看得到你的程式碼。很多知名的開源軟體都是公開的。

一個重要觀念：public 也不可怕

就算設成 public（公開）也不可怕，只要你的 .gitignore 有正確擋住 .env.local，公開的只是「程式碼邏輯」，你的金鑰永遠不會被看到。 很多知名開源軟體都是公開的，大家都看得到程式碼，但每個人跑的時候，都是填自己的金鑰（從那個空白範本複製去填）。這正是第 12 章「範本公開、實際內容保密」的威力。

6

日後更新的固定流程

學會之後，你以後每次改完程式、想更新到 GitHub，就是固定三步。

1 · 存檔 commit → 2 · 檢查清單 → 3 · 上傳 push
  1. 存檔（commit）：把這次的修改記錄成一個存檔點，附一句說明改了什麼。
  2. 檢查：瞄一眼要上傳的清單，確認沒有機密混進去。
  3. 上傳（push）：推送到雲端 repo。

熟練後這三步只要幾秒鐘，但中間那個檢查千萬別省。

本章重點回顧
  1. Git ＝ 本機存檔系統（記憶卡）；GitHub ＝ 雲端倉庫（Google 相簿）。
  2. commit ＝ 建立存檔點（附說明）；push ＝ 上傳到雲端；repo ＝ 專案在 GitHub 上的資料夾。
  3. 改壞了能回到過去：看版本紀錄、挑一個還原；回去前先 commit 現在的進度，新舊版本都不會丟。
  4. 上傳前一定要做安全檢查：確認 .env.local 等機密不在上傳清單裡。
  5. private / public：設公開也沒關係，只要 .gitignore 擋好機密，金鑰永遠不外洩。
課堂活動 · 寫三句 commit 說明
  • 想像你今天對一個專案做了三次修改（例如：加了登入頁、修了一個顏色、補了說明文件）。
  • 為每次修改寫一句清楚的 commit 說明（10 到 20 字），讓三個月後的你看得懂。
  • 比較「修了東西」這種模糊說明，和「修正登入按鈕在手機上跑版」這種具體說明，哪個對日後回顧更有用。
7

隨堂測驗：檢查你的 Git 判斷力

答對加 20 分，答錯倒扣 10 分。

第 1 / 5 題 目前得分：0