一、GitHub 是什麼？

GitHub 是一個全球最大的程式碼協作平台，也是開發者分享、管理和協作專案的雲端空間。它基於 Git 版本控制系統，不只儲存原始程式碼，還能追蹤每次修改，支援團隊跨地域合作，一起寫程式、討論功能、解決問題。

二、為什麼要將專案上傳到 GitHub？

• 備份安全：雲端儲存，不怕電腦壞掉、檔案遺失。
• 版本管理：每次修改都有紀錄，可以隨時回溯、比較。
• 協作方便：不論團隊規模如何，都能同步開發、開分支、不互相干擾。
• 展示作品集：公開專案可以當成「履歷」。
• 開放學習/貢獻：公開專案可讓社群互動、學習、甚至收到改進建議。

三、上傳專案到 GitHub 的準備工作

步驟一：準備帳號和專案

1. 到 Github 註冊一個帳號並登入。
2. 在電腦準備好專案資料夾（如程式碼、文件）。

步驟二：建立新的 Repository

1. 登入 GitHub，右上角「+」→「New repository」。
2. 輸入專案名稱、選擇是否公開（Public/Private），建議加上 README。
3. 按下「Create repository」。

四、用 Git 將專案上傳到 GitHub

Git 是什麼？

Git 是一套版本控制系統，意思是它能記錄程式（或任何檔案）的每次改動。就像「自動存檔功能」，任何時候都能追回、比較、管理。

• 分散式：每個人本地端（自己的電腦）也有完整的專案脈絡，不怕斷線。
• 效率高：適用大型專案、多人合作。
• 支援分支：平行開發、多重實驗、合併無壓力。

步驟一：安裝 Git

可至 Git 官網下載安裝。

步驟二：初始化專案

git init

Git 會創建一個隱藏 .git 資料夾，用來追蹤所有版本和設定。

步驟三：加入檔案到 Git 的追蹤（staging area）

git add .

# 如果只想加入特定檔案，可以用 git add <file_name>

步驟四：新增 .gitignore 並執行追蹤

(1) 建立 .gitignore

config/.env
venv/
*.pyc

(2) 確認 .gitignore 存在且正確。

步驟五：提交（commit）

git commit -m "第一次上傳"

步驟六：連結到遠端 GitHub

git remote add origin https://github.com/使用者帳號/專案名稱.git

步驟七：上傳專案到 GitHub

# 將主分支（名稱通常是 main 或 master）推送到遠端
# -u 參數會設定這個分支的上游，日後只需 git push 即可。
git push -u origin main

步驟八：更新/修改

每次修改後：git add . > git commit -m "說明" > git push（若有設定遠端），把最新版本同步到 GitHub。

五、常見 Git 指令