Git 團隊協作開發指南

Git 團隊協作開發指南

簡介

在團隊開發中，特別是遊戲開發項目（如使用 RPG Maker 等工具），有效的版本控制和協作流程至關重要。本指南將以遊戲開發為例，介紹如何使用 Git 進行團隊協作開發。

為什麼遊戲開發需要版本控制？

在遊戲開發過程中，團隊成員可能包括：

• 🎨 美術設計師：負責角色、場景、UI 設計
• 💻 程式設計師：負責遊戲邏輯、系統開發
• 📝 劇本編劇：負責故事、對話、任務設計
• 🎵 音效設計師：負責背景音樂、音效製作
• 🎮 關卡設計師：負責地圖、關卡佈局

多人同時修改遊戲內容時，沒有版本控制會導致：

• ❌ 檔案覆蓋和工作遺失
• ❌ 無法追蹤誰做了什麼修改
• ❌ 難以回溯到之前的版本
• ❌ 團隊成員之間的協調困難

團隊協作工作流程

1. Git Flow 分支策略

在遊戲開發中，建議採用以下分支結構：

main (master)          # 穩定的發布版本
  │
  ├─ develop           # 開發主分支
  │   │
  │   ├─ feature/character-system    # 角色系統功能
  │   ├─ feature/battle-system       # 戰鬥系統功能
  │   ├─ feature/map-design          # 地圖設計
  │   └─ feature/story-chapter1      # 第一章劇情
  │
  ├─ hotfix/critical-bug            # 緊急修復
  └─ release/v1.0                   # 發布準備分支

分支說明

主要分支：

• main (或 master)：只包含穩定的、可發布的版本
• develop：開發主分支，包含最新的開發進度

支援分支：

• feature/*：新功能開發分支
• hotfix/*：緊急錯誤修復分支
• release/*：版本發布準備分支

2. 實際操作流程

步驟 1：設置專案倉庫

專案負責人創建主倉庫：

# 創建本地倉庫
mkdir rpg-maker-project
cd rpg-maker-project
git init

# 創建基本結構
mkdir -p Assets/{Characters,Maps,Audio,Scripts}
mkdir -p Documentation

# 創建 .gitignore 文件（稍後詳述）
touch .gitignore

# 初始提交
git add .
git commit -m "Initial project setup"

# 推送到遠程倉庫（GitHub/GitLab）
git remote add origin <repository_url>
git push -u origin main

# 創建 develop 分支
git checkout -b develop
git push -u origin develop

步驟 2：團隊成員加入專案

團隊成員克隆倉庫：

# 克隆倉庫
git clone <repository_url>
cd rpg-maker-project

# 查看所有分支
git branch -a

# 切換到開發分支
git checkout develop

步驟 3：開發新功能

例如：美術設計師要添加新角色

# 從 develop 創建功能分支
git checkout develop
git pull origin develop
git checkout -b feature/add-hero-character

# 添加角色圖檔和設定
# 在 Assets/Characters/ 添加圖片和設定檔

# 查看更改
git status

# 添加更改到暫存區
git add Assets/Characters/hero_sprite.png
git add Assets/Characters/hero_config.json

# 提交更改
git commit -m "Add hero character sprite and configuration"

# 推送到遠程倉庫
git push origin feature/add-hero-character

步驟 4：創建 Pull Request

1. 在 GitHub/GitLab 上打開專案倉庫
2. 點擊 “New Pull Request” 或 “Create Merge Request”
3. 選擇：feature/add-hero-character → develop
4. 填寫 PR 描述：

   ## 添加主角角色
   
   ### 變更內容
   - 添加主角精靈圖（hero_sprite.png）
   - 添加角色配置文件（hero_config.json）
   
   ### 測試
   - [x] 圖片格式正確
   - [x] 配置文件格式驗證通過
   - [x] 在 RPG Maker 中可正常載入
   
   ### 相關 Issue
   Closes #15
   

5. 請求團隊成員審查

步驟 5：程式碼審查

審查者檢查更改：

# 拉取 PR 分支
git fetch origin
git checkout feature/add-hero-character

# 在 RPG Maker 中測試
# 檢查圖片品質、配置正確性

# 在 GitHub/GitLab 上留下評論
# - 如果沒問題：批准 PR
# - 如果需要修改：請求更改

步驟 6：合併到開發分支

專案負責人合併 PR：

# 確保在 develop 分支
git checkout develop
git pull origin develop

# 合併功能分支（使用 --no-ff 保留分支歷史）
git merge --no-ff feature/add-hero-character

# 推送到遠程
git push origin develop

# 刪除已合併的功能分支（可選）
git branch -d feature/add-hero-character
git push origin --delete feature/add-hero-character

3. 處理衝突

當多人修改同一個文件時，可能會產生衝突。

例如：兩個設計師都修改了同一個地圖檔案

# 嘗試合併時出現衝突
git merge feature/map-update-alice
# 衝突訊息：CONFLICT (content): Merge conflict in Assets/Maps/town.json

# 查看衝突文件
git status

# 打開衝突文件，會看到類似內容：
# <<<<<<< HEAD
# "npc_count": 5
# =======
# "npc_count": 7
# >>>>>>> feature/map-update-alice

# 手動解決衝突（保留正確的版本或合併兩者）
# 編輯文件後：
git add Assets/Maps/town.json
git commit -m "Resolve merge conflict in town map"

最佳實踐：

• 🔔 經常從 develop 拉取最新更改
• 💬 在修改共享文件前與團隊溝通
• 🔄 保持功能分支短小，盡快合併
• 📞 遇到複雜衝突時，與相關開發者討論

RPG Maker 專案的特殊考慮

1. .gitignore 設置

RPG Maker 項目會產生許多臨時文件和大型二進制文件，需要正確設置 .gitignore：

# RPG Maker 臨時文件
*.rpgproject
*.rxproj
*.rvproj
*.autosave

# 編輯器臨時文件
*.tmp
*.bak
*~

# 作業系統文件
.DS_Store
Thumbs.db
desktop.ini

# 大型資源文件（考慮使用 Git LFS）
# *.ogg
# *.mp4
# *.webm

# 測試存檔
save*.rvdata2
save*.rpgsave

# 部署文件
/www/
/nwjs/
*.zip
*.7z

2. 處理大型二進制文件

遊戲開發涉及大量圖片、音頻、視頻文件。建議使用 Git LFS（Large File Storage）：

# 安裝 Git LFS
git lfs install

# 追蹤大型文件類型
git lfs track "*.png"
git lfs track "*.jpg"
git lfs track "*.ogg"
git lfs track "*.mp3"
git lfs track "*.mp4"
git lfs track "*.webm"

# 確認 .gitattributes 文件已創建
cat .gitattributes

# 添加和提交
git add .gitattributes
git commit -m "Configure Git LFS for large assets"

3. 文件命名規範

建立清晰的命名規範：

Assets/
├── Characters/
│   ├── hero_idle.png
│   ├── hero_walk.png
│   ├── npc_merchant_idle.png
│   └── enemy_goblin_attack.png
├── Maps/
│   ├── map_town_central.json
│   ├── map_dungeon_floor1.json
│   └── map_castle_throne.json
├── Audio/
│   ├── bgm_battle_boss.ogg
│   ├── bgm_town_peaceful.ogg
│   └── sfx_sword_slash.ogg
└── Scripts/
    ├── battle_system.js
    ├── inventory_system.js
    └── dialog_system.js

命名原則：

• 使用小寫字母和底線
• 包含類型前綴（hero_, npc_, enemy_, map_, bgm_, sfx_）
• 描述性名稱，便於搜尋

4. 提交訊息規範

使用清晰、一致的提交訊息：

# 格式：<類型>: <簡短描述>
# 
# <詳細說明>（可選）
# 
# <相關 Issue>（可選）

# 好的範例：
git commit -m "feat: add boss battle system

- Implement phase-based boss mechanics
- Add special attack patterns
- Integrate with existing battle UI

Closes #42"

git commit -m "fix: resolve dialog text overflow issue

Text was wrapping incorrectly on smaller screens.
Added auto-scaling for different resolutions.

Fixes #38"

git commit -m "asset: add chapter 2 background music"

git commit -m "docs: update character design guidelines"

提交類型：

• feat: 新功能
• fix: 錯誤修復
• asset: 資源文件添加/更新
• refactor: 代碼重構
• docs: 文檔更新
• test: 測試相關
• chore: 構建、配置相關

協作最佳實踐

1. 日常工作流程

每天開始工作前：

# 拉取最新更改
git checkout develop
git pull origin develop

# 更新你的功能分支
git checkout feature/your-feature
git merge develop

# 或使用 rebase 保持歷史整潔
git rebase develop

每天結束工作時：

# 提交當天的工作
git add .
git commit -m "feat: implement character movement system (WIP)"
git push origin feature/your-feature

2. 團隊溝通

• 📅 每日站會：同步進度，識別阻礙
• 📝 使用 Issue 追蹤：記錄任務、Bug、改進建議
• 💬 PR 中討論技術細節：保留決策歷史
• 📊 使用專案看板：視覺化工作流程（GitHub Projects/Trello）

3. 程式碼審查指南

審查者應檢查：

• ✅ 程式碼品質和可讀性
• ✅ 是否符合專案規範
• ✅ 是否有適當的註釋
• ✅ 資源文件是否正確命名
• ✅ 是否有遺漏的文件
• ✅ 是否測試過功能

審查者態度：

• 🤝 友善、建設性的反饋
• 💡 提供具體的改進建議
• 👍 認可好的實作
• ❓ 提問而非批評

4. 發布流程

準備發布新版本：

# 從 develop 創建 release 分支
git checkout develop
git pull origin develop
git checkout -b release/v1.0

# 更新版本號、變更日誌
# 修復最後的小 bug
git commit -m "chore: prepare for v1.0 release"

# 合併到 main 和 develop
git checkout main
git merge --no-ff release/v1.0
git tag -a v1.0 -m "Version 1.0 - Initial Release"
git push origin main --tags

git checkout develop
git merge --no-ff release/v1.0
git push origin develop

# 刪除 release 分支
git branch -d release/v1.0

建立變更日誌（CHANGELOG.md）:

# 變更日誌

## [1.0.0] - YYYY-MM-DD

### 新增
- 完整的戰鬥系統
- 五個主要角色可選
- 10 個關卡地圖
- 背景音樂和音效

### 修復
- 修復存檔載入時的崩潰問題
- 解決對話框文字溢出
- 修正敵人 AI 行為異常

### 改進
- 優化遊戲載入速度
- 提升戰鬥動畫流暢度

常見問題與解決方案

問題 1：忘記創建分支，直接在 develop 上開發

# 保存當前工作
git stash

# 創建並切換到新分支
git checkout -b feature/your-feature

# 恢復工作
git stash pop

問題 2：提交到錯誤的分支

# 如果還沒 push，重置並切換分支
git reset HEAD~1
git checkout correct-branch
git add .
git commit -m "your commit message"

問題 3：需要撤銷已推送的提交

# 創建反向提交（推薦，保留歷史）
git revert <commit_hash>
git push origin branch-name

# 或者（僅限個人分支，會改寫歷史）
git reset --hard <commit_hash>
git push --force origin branch-name

問題 4：不小心刪除了重要文件

# 如果還沒提交，恢復文件
git checkout -- <filename>

# 如果已經提交，找回之前版本
git log -- <filename>
git checkout <commit_hash> -- <filename>

工具推薦

Git 圖形界面工具

• SourceTree：功能強大的免費 Git GUI
• GitKraken：視覺化分支管理
• GitHub Desktop：簡單易用，適合初學者
• VS Code Git 擴充：在編輯器內操作 Git

協作工具

• GitHub/GitLab：代碼託管和協作平台
• Slack/Discord：團隊即時通訊
• Trello/Notion：專案管理
• Figma：設計協作（美術資源）

RPG Maker 相關

• RPG Maker MV/MZ：遊戲開發引擎
• Tiled：地圖編輯器
• Aseprite：像素圖編輯
• Audacity：音頻編輯

總結

成功的團隊協作需要：

1. 📋 清晰的工作流程：使用 Git Flow 或類似策略
2. 🎯 明確的責任分工：每個人知道自己負責什麼
3. 💬 良好的溝通：及時同步進度和問題
4. 📝 規範的提交訊息：便於追蹤和回溯
5. 🔍 嚴謹的程式碼審查：確保品質
6. 🔄 頻繁的整合：減少合併衝突
7. 📚 完善的文檔：幫助新成員快速上手

遵循這些原則，你的團隊將能高效地協作開發出優秀的遊戲作品！

延伸學習

• Git Tutorial - Git 基礎教學
• Pull Request Tutorial - PR 詳細流程
• Git 官方文檔
• GitHub Flow 指南
• Atlassian Git Tutorials

---

🎮 祝你的遊戲開發專案順利！💻 Happy Coding!