本日重點

• 學習用 Git 管理專案版本與協作流程
• 練習將本地專案完整上傳至 GitHub，建立雲端儲存與分享
• 熟悉常用 Git 指令（init、add、commit、push、clone）
• 體會開源協作精神，並規劃如何串接 Web3/健康護照等後續功能

一、認識 GitHub

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

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

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

如果想放在 Hugging Face 的話，可以參考：

• Day 9. Hugging Face Spaces 部署實作 Ep. 1
• Day10. Hugging Face Spaces 部署實作 Ep. 2

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

step 1. 準備帳號和專案

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

step 2. 建立新的 Repository

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

四、用 Git 將專案上傳到 GitHub

1. 認識 Git

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

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

step 1. 安裝 Git

可至 Git 官網下載安裝。

step 2. 初始化專案

git init

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

step 3. 加入檔案到 Git 的追蹤（staging area）

git add .

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

step 4. 新增 .gitignore 並執行追蹤

(1) 建立 .gitignore

config/.env
venv/
*.pyc

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

step 5. 提交（commit）

git commit -m "第一次上傳"

step 6. 連結到遠端 GitHub

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

step 7. 上傳專案到 GitHub

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

step 8. 更新/修改

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

五、常見 Git 指令

六、延伸閱讀

• Git 官方文件
• GitHub 新手入門教學
• 常用 Git 指令總覽
• GitHub Actions 自動化教學