A.4 商業衝突仲裁與無痛合併:終結 <<<<<<< HEAD 的惡夢
學完本節,你能夠:
- 說明合併衝突(merge conflict)發生的條件,以及為什麼 Git 不會替你決定。
- 讀懂衝突標記
<<<<<<<、=======、>>>>>>>,把檔案改成正確內容並完成合併。 - 在談不攏時用
git merge --abort安全退回合併前的狀態。
壹、開場情境:同一款鍵盤,兩個價格
📌 以下為教學情境(依實務改編)。
A 款鍵盤目前報價 €112(毛利率 20.6%,匯率 31.5)。同一週內:
| 誰 | 在哪裡改 | 改成 | 理由 | 毛利率 |
|---|---|---|---|---|
| 台北財務 | main |
€118 | 匯率可能繼續下跌,想多留緩衝 | 24.7% |
| 德國業務 | sales/de-bulk 分支 |
€105 | 大客戶一次訂 2,000 把,要求折扣 | 15.3% |
德國業務想把分支合併回 main 時,Git 停了下來:
Auto-merging quotes.csv
CONFLICT (content): Merge conflict in quotes.csv
Automatic merge failed; fix conflicts and then commit the result.
本節要解決的問題: 衝突發生時,怎麼看懂雙方各改了什麼、做出決定、完成合併,或在談不攏時安全撤回?
貳、為什麼會衝突
Git 合併時會比對三個版本:兩條分支「分岔前的共同版本」、main 的版本、分支的版本。
A款 €112"] --> M["main(台北財務)
A款 €118"] B --> S["sales/de-bulk(德國業務)
A款 €105"] M --> C{"同一行被兩邊改成
不同內容"} S --> C C --> H["Git 停下來
交給人決定"]
| 兩邊的修改 | Git 的處理 |
|---|---|
| 只有一邊改了某一行 | 自動採用改過的那邊 |
| 兩邊改了相距較遠的不同行 | 自動合併 |
| 兩邊改了同一行或相鄰的行 | 🛑 衝突,等人處理 |
| 兩邊改成一模一樣的內容 | 自動合併 |
衝突不是系統壞掉,而是 Git 偵測到兩個人做了互相矛盾的決定。 它不知道該保毛利還是搶訂單,這是本質性困難(第 1.1 節),只能由人決定。
⚠️ 沒有衝突,不代表沒有問題
Git 只看文字是否重疊,不懂商業邏輯。兩人改了不同行、自動合併成功,組合起來仍可能是一張不合格的報價。合併後一定要再執行一次
checkQuotes()檢查毛利。
參、把規則寫下來:衝突由誰決定?
| 公司口頭說法 | 需要追問的問題 | 寫成規格 |
|---|---|---|
| 「有衝突就協調」 | 誰有最後決定權? | 報價衝突由業務主管決定;低於 15% 底線須財務同意 |
| 「找個中間價」 | 中間價要符合什麼條件? | 毛利率 ≥ 15%(MIN_MARGIN),並記錄雙方原始價格 |
| 「決定了就改」 | 理由記在哪? | 寫在合併提交的說明裡 |
| (沒人說) | 協調不出來怎麼辦? | 放棄這次合併(git merge --abort),main 維持原狀 |
肆、動手做
1. 看衝突在哪裡
對代理說:「合併發生衝突,列出衝突的檔案,並把雙方的版本與各自的 commit 說明並排給我看。」
git status
On branch main
You have unmerged paths.
(fix conflicts and run "git commit")
(use "git merge --abort" to abort the merge)
Unmerged paths:
(use "git add <file>..." to mark resolution)
both modified: quotes.csv
both modified 表示兩邊都改了這個檔案。打開 quotes.csv,會看到 Git 插入的衝突標記:
產品名稱,單位成本TWD,歐元報價EUR
<<<<<<< HEAD
人體工學鍵盤A款,2800,118
=======
人體工學鍵盤A款,2800,105
>>>>>>> sales/de-bulk
無線雙模鍵盤B款,3900,150
靜電容旗艦鍵盤C款,4800,180
| 標記 | 意思 |
|---|---|
<<<<<<< HEAD 到 ======= |
你目前所在分支(main)的版本 |
======= 到 >>>>>>> sales/de-bulk |
要合併進來的分支版本 |
⚠️ 衝突期間,這個檔案不能拿去用。帶著
<<<<<<<符號的 CSV 匯入任何系統都會出錯。
2. 讓代理幫你整理,但由人決定
代理能做的是:讀出雙方的價格、找出各自 commit 說明裡的理由、依第 1.1 節公式算出毛利率與紅線匯率。代理不知道你們在會議或電話裡談了什麼;commit 說明寫得越清楚,代理整理得越完整。
| 方案 | A 款報價 | 毛利率 | 紅線匯率(低於此值就跌破 15%) |
|---|---|---|---|
| 台北財務 | €118 | 24.7% | 27.92 |
| 德國業務 | €105 | 15.3% | 31.37 |
| 折衷 | €110 | 19.2% | 29.95 |
紅線匯率 = 2,800 ÷ (報價 × 0.85)。德國方案的紅線匯率 31.37 幾乎貼著目前的 31.5,匯率再小跌就不及格。業務主管與財務通話後,決定採用折衷價 €110。
3. 解決衝突並完成合併
對代理說:「把 quotes.csv 的衝突改成 A 款 €110,刪掉所有衝突標記,然後完成合併,說明寫上雙方原價與決定理由。」
代理(或你自己)要把檔案改成:
產品名稱,單位成本TWD,歐元報價EUR
人體工學鍵盤A款,2800,110
無線雙模鍵盤B款,3900,150
靜電容旗艦鍵盤C款,4800,180
然後告訴 Git「這個檔案處理好了」,並提交:
git add quotes.csv
git commit -m "merge: A款折衷定價 €110(台北 €118、德國 €105)" -m "業務主管與財務同意;毛利率 19.2%,紅線匯率 29.95。"
💡 驗收重點 - 檔案裡還有沒有
<<<<<<<、=======、>>>>>>>?(用編輯器搜尋,或請代理檢查) - 合併後重新跑一次checkQuotes(),A 款是否 ✅ 放行? -git log --oneline --graph是否出現兩條線匯合的合併提交?
這個合併提交有兩個「上一版」,分別指向台北與德國的 commit,所以日後查歷史,兩邊的原始提案都還在。
💡 很多以 VS Code 為基礎的編輯器,會把衝突區塊標上顏色,並提供「保留目前」「保留傳入」「兩者都保留」等按鈕。但本例的答案是第三個價格 €110,任何一個按鈕都不對,仍要手動修改。
4. 談不攏:撤回合併
如果雙方一時無法達成共識:
對代理說:「取消這次合併,回到合併前的狀態。」
git merge --abort
執行後,quotes.csv 回到 main 的版本(A 款 €118),衝突標記全部消失,德國業務的分支也原封不動,之後可以再合併一次。
⚠️
git merge --abort只保證能回到合併開始前的狀態。如果你在開始合併前就有未存檔的修改,那些修改可能無法完整還原。所以合併前先用git status確認工作目錄是乾淨的。
伍、跑跑看、壞給你看
| 實驗 | 操作 | 預期結果 | 想想看 |
|---|---|---|---|
| ① 不同行 | 一個分支改 A 款(第 2 行),另一個改 C 款(第 4 行),然後合併 | 自動合併成功,兩個修改都保留 | 自動合併後,還需要檢查什麼? |
| ② 相鄰行 | 一個分支改 A 款(第 2 行),另一個改 B 款(第 3 行),然後合併 | 🛑 發生衝突 | 明明改的是不同產品,為什麼也會衝突? |
| ③ 忘了刪標記 | 只改價格、留下 =======,就 git add 再 commit |
Git 照樣讓你提交 | Git 不會替你檢查內容,誰該負責檢查? |
| ④ Excel 衝突 | 兩個分支同時修改同一個 .xlsx |
顯示 Cannot merge binary files,只能整份二選一 |
這是 A.1 建議用 CSV 的原因之一 |
陸、回到情境與小結
衝突讓「台北要 €118、德國要 €105」這個分歧在合併當下就浮上檯面,而不是等到客戶收到兩份不同報價才發現。最後的 €110 與決定理由都寫進了合併提交。
| 限制 | 後果 | 在哪一節解決 |
|---|---|---|
| 衝突在合併當下才發現 | 協調時間壓力大 | A.6:用 Pull Request 提早讓雙方看到修改 |
| 誰有權決定沒有寫進系統 | 先合併的人說了算 | A.6 審核規則;第 9 章 權限設計 |
| 自動合併可能組合出不合格報價 | 沒衝突就沒人檢查 | 合併後執行 checkQuotes();第 5 章 測試 |
本節小結
- 兩條分支改了同一行或相鄰行,Git 就會停下來,把決定權交給人。
- 衝突標記中,
HEAD那段是你目前分支的版本,>>>>>>>後面是要合併進來的分支。 - 解決方式:改好檔案、刪掉標記 →
git add→git commit,並在說明中寫下決定與理由。 - 談不攏就
git merge --abort;但沒衝突也不代表報價合格。
柒、練習
- 改數字(5 分鐘):如果折衷價改成 €108,毛利率與紅線匯率各是多少?請寫出你會用的合併提交說明。
- 製造並解決衝突(20 分鐘):自己建一個版本庫,開兩個分支分別把 B 款改成 €140 與 €160,合併時產生衝突,再以 €155 解決。最後用
git log --oneline --graph截圖。 - 管理反思(討論):有人建議「讓 AI 代理自動解決所有衝突,選毛利比較高的那一邊」。這條規則在什麼情況下會出問題?哪些衝突可以交給代理,哪些一定要人決定?