
🚀 GitHub 版本管控實戰教學
這是一份 GitHub 版本管控的實務教學,模擬一個 三人團隊 共同開發專案的完整流程,包含 專案建立、分支管理、協作流程、合併(Merge)、版本發布(Releases) 等內容。
🛠️ 模擬場景
- 專案名稱:
team-project
- 團隊成員
- Alice(負責前端)
- Bob(負責後端)
- Charlie(負責測試)
1️⃣ 初始化專案
🔹 (1) 創建 GitHub 儲存庫
- 登入 GitHub,點擊 「New Repository」
- 設定:
- Repository Name:
team-project
- Visibility:選擇
Private
(內部開發)或Public
- 初始化設定:
- ✔
Add a README.md
- ✔
.gitignore
(選擇 Node.js 或 Python) - ✔
MIT License
- ✔
- Repository Name:
- 點擊 「Create Repository」 ✅
🔹 (2) Clone 專案到本地
git clone https://github.com/your-team/team-project.git cd team-project
2️⃣ 版本控制基礎
🔹 (1) 設定主分支(Main Branch)
- 檢查當前分支
git branch
輸出* main
- 設定分支保護
- 進入 GitHub →
Settings
→Branches
- 選擇
Add branch protection rule
- 設定:
- ✅
Require pull request before merging
- ✅
Require status checks
- ✅
Include administrators
- ✅
- 目標:強制 PR 合併,不能直接 Push 到
main
。
- 進入 GitHub →
🔹 (2) 建立開發分支
🚀 團隊規範
feature-xxx
:新功能bugfix-xxx
:修復問題hotfix-xxx
:緊急修復release-xxx
:版本管理
範例:Alice 負責開發首頁
git checkout -b feature-homepage
3️⃣ 團隊開發與協作
🔹 (1) Alice 編寫程式並提交
- 修改
index.html
<h1>Welcome to Our Project</h1>
- 提交變更
git add . git commit -m "新增首頁設計" git push origin feature-homepage
🔹 (2) 提交 Pull Request(PR)
- 進入 GitHub →
Pull Requests
→New Pull Request
- 選擇分支
- Base:
main
- Compare:
feature-homepage
- Base:
- 填寫 PR 說明
✅ 新增首頁 UI - 設計首頁結構 - 加入 CSS 樣式
- 指派 Reviewer(Charlie)
- 提交 PR
🔹 (3) 進行 Code Review
🚀 Charlie 進行 Code Review
- 進入 PR,點擊
Files Changed
- 留下意見:
💡 建議調整標題顏色
- Alice 修正後再次提交:
git add . git commit -m "調整首頁標題顏色" git push origin feature-homepage
- Charlie Approve PR,Alice Merge PR
- 刪除開發分支
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
- 進入 GitHub →
Releases
- 點擊
Draft a new release
- 填寫版本資訊
🎉 v1.0 版本發布 ✅ 新增首頁 UI ✅ 建立後端 API ✅ 完成基本測試
- 發布版本 🎉
5️⃣ CI/CD 自動化
🔹 (1) 設置 GitHub Actions
- 在
.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
- 每次 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 版本管控的 團隊協作流程 就完整落地了!🚀 這種方式適用於 學生專案、企業開發、開源專案 等場景,確保開發有條不紊、版本可追溯。 💡
你可以試著實作看看,或根據你的專案需求調整細節!💪