A.4 商業衝突仲裁與無痛合併:終結 <<<<<<< HEAD 的惡夢

學完本節,你能夠:

  1. 說明合併衝突(merge conflict)發生的條件,以及為什麼 Git 不會替你決定。
  2. 讀懂衝突標記 <<<<<<<、=======、>>>>>>>,把檔案改成正確內容並完成合併。
  3. 在談不攏時用 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 的版本、分支的版本。

flowchart TD B["共同版本
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 章 測試

本節小結

  1. 兩條分支改了同一行或相鄰行,Git 就會停下來,把決定權交給人。
  2. 衝突標記中,HEAD 那段是你目前分支的版本,>>>>>>> 後面是要合併進來的分支。
  3. 解決方式:改好檔案、刪掉標記 → git add → git commit,並在說明中寫下決定與理由。
  4. 談不攏就 git merge --abort;但沒衝突也不代表報價合格。

柒、練習

  1. 改數字(5 分鐘):如果折衷價改成 €108,毛利率與紅線匯率各是多少?請寫出你會用的合併提交說明。
  2. 製造並解決衝突(20 分鐘):自己建一個版本庫,開兩個分支分別把 B 款改成 €140 與 €160,合併時產生衝突,再以 €155 解決。最後用 git log --oneline --graph 截圖。
  3. 管理反思(討論):有人建議「讓 AI 代理自動解決所有衝突,選毛利比較高的那一邊」。這條規則在什麼情況下會出問題?哪些衝突可以交給代理,哪些一定要人決定?

國立臺中科技大學 國際貿易系 / 企業管理系 專用教材

《現代軟體工程:商學院的 AI 系統思維與 Agent 實踐》

作者:陳俊智 博士 Dr. Chun-Chih Chen

本書章節架構改編自陳鍾誠教授(金門大學)開源課程《現代軟體工程》(github.com/ccc115a/se,MIT 授權),內容針對商學院全面改寫與擴充。