這是一份 GitHub 版本管控的實務教學，模擬一個 三人團隊 共同開發專案的完整流程，包含 專案建立、分支管理、協作流程、合併（Merge）、版本發布（Releases） 等內容。

---

🛠️ 模擬場景

• 專案名稱：team-project
• 團隊成員
  • Alice（負責前端）
  • Bob（負責後端）
  • Charlie（負責測試）

---

1️⃣ 初始化專案

🔹 (1) 創建 GitHub 儲存庫

1. 登入 GitHub，點擊 「New Repository」
2. 設定：
   • Repository Name：team-project
   • Visibility：選擇 Private（內部開發）或 Public
   • 初始化設定：
     • ✔ Add a README.md
     • ✔ .gitignore（選擇 Node.js 或 Python）
     • ✔ MIT License
3. 點擊 「Create Repository」 ✅

---

🔹 (2) Clone 專案到本地

git clone https://github.com/your-team/team-project.git
cd team-project

---

2️⃣ 版本控制基礎

🔹 (1) 設定主分支（Main Branch）

1. 檢查當前分支 git branch 輸出 * main
2. 設定分支保護
   • 進入 GitHub → Settings → Branches
   • 選擇 Add branch protection rule
   • 設定：
     • ✅ Require pull request before merging
     • ✅ Require status checks
     • ✅ Include administrators
   • 目標：強制 PR 合併，不能直接 Push 到 main。

---

🔹 (2) 建立開發分支

🚀 團隊規範

• feature-xxx：新功能
• bugfix-xxx：修復問題
• hotfix-xxx：緊急修復
• release-xxx：版本管理

範例：Alice 負責開發首頁

git checkout -b feature-homepage

---

3️⃣ 團隊開發與協作

🔹 (1) Alice 編寫程式並提交

1. 修改 index.html <h1>Welcome to Our Project</h1>
2. 提交變更 git add . git commit -m "新增首頁設計" git push origin feature-homepage

---

🔹 (2) 提交 Pull Request（PR）

1. 進入 GitHub → Pull Requests → New Pull Request
2. 選擇分支
   • Base：main
   • Compare：feature-homepage
3. 填寫 PR 說明 ✅ 新增首頁 UI - 設計首頁結構 - 加入 CSS 樣式
4. 指派 Reviewer（Charlie）
5. 提交 PR

---

🔹 (3) 進行 Code Review

🚀 Charlie 進行 Code Review

1. 進入 PR，點擊 Files Changed
2. 留下意見： 💡 建議調整標題顏色
3. Alice 修正後再次提交： git add . git commit -m "調整首頁標題顏色" git push origin feature-homepage
4. Charlie Approve PR，Alice Merge PR
5. 刪除開發分支 git branch -d feature-homepage git push origin --delete feature-homepage

---

4️⃣ 版本發布（Releases）

🔹 (1) 建立版本標籤

🚀 團隊完成 v1.0 功能

git tag -a v1.0 -m "正式版發布"
git push origin v1.0

🔹 (2) GitHub Releases

1. 進入 GitHub → Releases
2. 點擊 Draft a new release
3. 填寫版本資訊 🎉 v1.0 版本發布 ✅ 新增首頁 UI ✅ 建立後端 API ✅ 完成基本測試
4. 發布版本 🎉

---

5️⃣ CI/CD 自動化

🔹 (1) 設置 GitHub Actions

1. 在 .github/workflows/ci.yml 新增： name: CI Pipeline on: [push, pull_request] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Install dependencies run: npm install - name: Run Tests run: npm test
2. 每次 PR 會自動測試，確保程式碼品質 ✅

---

🔥 總結

步驟	操作
建立專案	git clone、初始化 GitHub Repository
分支管理	feature-xxx、bugfix-xxx
開發流程	git checkout -b feature-name
提交 PR	git push origin feature-name
Code Review	透過 GitHub 留言審核
合併主分支	git merge
版本發布	git tag v1.0
CI/CD 自動化	GitHub Actions 進行測試

---

這樣，整個 GitHub 版本管控的 團隊協作流程 就完整落地了！🚀 這種方式適用於 學生專案、企業開發、開源專案 等場景，確保開發有條不紊、版本可追溯。 💡

你可以試著實作看看，或根據你的專案需求調整細節！💪