## 🧭 1. 確認目前所在的分支與狀態

git branch -v

✅ 顯示目前所有本地分支（`*` 表示當前分支）
✅ 確認自己目前是否在要上傳的開發分支上，例如 `feature/zj-fix-bug`

---

## 📤 2. 將開發內容上傳到遠端（origin）

git add .
git commit -m "✨ 描述這次修改的內容，例如：修正歷史紀錄分頁問題"
git push -u origin 你現在的分支名稱

✅ `-u` 是第一次 push 分支會用，讓之後可以簡單用 `git push`
✅ commit 訊息建議語意清楚，如：`feat: 新增盤點匯出 PDF 功能`

---

## 🔄 3. 回到主分支 `main`（或叫 `master`）

git checkout main

⚠️ 確保 `main` 是你們專案的正式整合分支。

---

## 🔃 4. 拉取最新的 `main` 資料

git pull origin main

✅ 確保你要合併的 base 是最新的
✅ 避免合併時混入舊版本錯誤

---

## 🔗 5. 合併你的開發分支到主分支

git merge 你的分支名稱

📌 這步會把你剛剛 push 的內容合併到 `main`
✅ 若無衝突會直接成功
⚠️ 若有衝突，Git 會提示你要手動解決

---

## 🧩 6. 若有衝突 → 解決後再提交一次

# 修改完有衝突的檔案後
git add .
git commit -m "♻️ 解決合併衝突，完成合併"

✅ `git status` 可以幫你檢查還有沒有檔案沒解衝突

---

## 🚀 7. 推送合併後的主分支到遠端

git push -u origin main

✅ 完成主分支更新
✅ 其他成員就可以 `git pull` 取得最新合併內容

---

## 🧹 8. 刪除開發分支（若已不需要）

### 本地刪除：

git branch -d 你的分支名稱

### 遠端刪除：

git push origin --delete 你的分支名稱

✅ 清理已合併完成的分支
✅ 保持遠端 Git 分支乾淨整潔

---

## ✅ 補充：建立新分支（開發前）

git checkout -b feature/你的功能名稱

✅ 建立並切換到新分支，建議名稱語意清楚

---

### 🎯 最後建議

- 每個功能或修正都用一個獨立分支（遵守 Git Flow）
- Commit 訊息要具體、簡潔，方便之後查閱
- 多人開發時，每次 push 前先 `pull origin main` 保持同步
- 有衝突別慌，一步步解決後再 commit 推上去！

---