G.4 迴圈與批量處理:for / while 在多筆貨櫃迭代與延滯費計算

學完本節,你能夠:

  1. 用 for 搭配 enumerate()、.items() 逐筆處理清單與字典,並用累加器算出總額。
  2. 用 while 處理「不知道要做幾次、只知道何時停」的問題,並避免無窮迴圈。
  3. 用 continue 跳過異常資料、用 break 中止流程,並把分段累進費率正確寫成程式。

壹、開場情境:每週一次的延滯費對帳

📌 以下為教學情境(依實務改編)。

小安轉調到合作的貨運承攬公司實習。進口貨櫃在港口卸船後有幾天免費期,貨主超過期限還沒把貨櫃領走,船公司就按天收貨櫃延滯費(Demurrage),承攬公司再向貨主收取。

每週一,營運組要把上週卸船的貨櫃逐一算延滯費。上週出了兩件事:

  • 有人把逾期 7 天的貨櫃整段用高費率計算,多算了貨主 USD 350,被客戶投訴。
  • 有一櫃貨值只有幾百美元,延滯費早就超過貨值,貨主一直沒出現,等到發現時已經累積了好幾週。

這週有 7 櫃,下個月預計每週 70 櫃。

本節要解決的問題: 同樣的計算規則,怎麼讓電腦對每一櫃各做一次,並在途中跳過壞資料、標出高風險櫃?

⚠️ 名詞釐清 本節的「延滯費」指船公司收的貨櫃使用費。海關的「滯報費」是進口人超過期限才報關時,依《關稅法》加徵的費用,兩者是不同的東西,不要混用。


貳、為什麼要用迴圈:兩種迴圈、兩個煞車

工具 用途 外貿例子
for 手上有一批資料,每一筆都做一次 7 個貨櫃各算一次延滯費
while 不知道要做幾次,直到某條件不成立才停 議價時一直讓價,直到毛利快跌破底線
continue 跳過這一筆,繼續下一筆 天數是負數的壞資料,記下來後跳過
break 整個迴圈結束 抽檢發現危險品,後面不用再檢查

1. for:逐筆處理

enumerate() 同時給你「第幾筆」和「內容」;字典用 .items() 同時取出鍵和值:

urgent_shipments = ["晶圓光罩", "醫療耗材", "伺服器主機板"]

for idx, item in enumerate(urgent_shipments, start=1):
    print(f"第 {idx} 優先:{item}")
第 1 優先:晶圓光罩
第 2 優先:醫療耗材
第 3 優先:伺服器主機板
exchange_rates = {"USD": 32.20, "EUR": 35.10, "JPY": 0.215}

for currency, rate in exchange_rates.items():
    print(f"{currency}: {rate:>7.3f}")
USD:  32.200
EUR:  35.100
JPY:   0.215

迴圈內要縮排,縮排內的每一行都會對每一筆執行一次。

2. while:直到條件不成立

用第 1.1 節的 A 款鍵盤:目前報價 €112,客戶一直殺價,每次讓 €1,最多能讓到多少?

# 議價讓步:每次讓 €1,最多能讓到多少,毛利率才不會跌破底線?
MIN_MARGIN = 0.15     # 毛利底線(同第 1.1 節)
COST_TWD = 2800       # A 款鍵盤台幣成本
RATE = 31.5           # 歐元匯率

price = 112           # 目前報價(€)
rounds = 0

# 只要「再讓 €1」之後毛利率仍守得住,就繼續讓
while 1 - COST_TWD / ((price - 1) * RATE) >= MIN_MARGIN:
    price -= 1
    rounds += 1

margin = 1 - COST_TWD / (price * RATE)
print(f"最多讓 {rounds} 次,最低報價 €{price},毛利率 {margin:.1%}")
最多讓 7 次,最低報價 €105,毛利率 15.3%

price -= 1 是 price = price - 1 的簡寫。

⚠️ 無窮迴圈 while 的條件如果永遠成立(例如忘了寫 price -= 1,價格永遠不變),程式就不會停。遇到時在終端機按 Ctrl + C 中斷。

3. continue 與 break

# 裝櫃前抽檢:免檢品略過,發現危險品立即停止裝櫃
cargo_list = ["棉布", "玩具", "未標示化學液體", "成衣", "鞋類"]

for cargo in cargo_list:
    if cargo == "玩具":
        print(f"略過:{cargo}(本批免檢)")
        continue          # 跳過這一筆,直接看下一筆
    if "未標示" in cargo:
        print(f"🛑 發現{cargo},停止裝櫃,通報主管")
        break             # 整個迴圈結束,後面不再檢查
    print(f"檢查合格:{cargo}")
檢查合格:棉布
略過:玩具(本批免檢)
🛑 發現未標示化學液體,停止裝櫃,通報主管

成衣和鞋類沒有被檢查,因為 break 已經結束了迴圈。


參、把規則寫下來:延滯費計算規格

合約說法 追問 寫成規格
「7 天免費」 第 7 天算不算? 停放 ≤ 7 天不收費;逾期天數 = 停放天數 − 7
「前 5 天每天 50」 從哪天算起? 逾期第 1~5 天,每櫃每天 USD 50
「之後每天 120」 是全部天數都用 120 嗎? 只有逾期第 6 天起用 120;前 5 天仍用 50(分段累進)
「貨主可能棄貨」 什麼情況算高風險? 延滯費 > 貨值 → 標示 🚨,通知業務與法務評估後續處置
(沒說) 天數是負數? 資料異常:不計費,列入待查清單

用公式寫:

逾期天數 = max(停放天數 − 7, 0)
第一段天數 = min(逾期天數, 5)
第二段天數 = 逾期天數 − 第一段天數
延滯費 = 第一段天數 × 50 + 第二段天數 × 120

以停放 16 天為例:逾期 9 天 → 第一段 5 天、第二段 4 天 → 5 × 50 + 4 × 120 = USD 730。

(本節費率為教學用假設值,實際依船公司費率表與合約。)


肆、寫出來

在 TradeLab 資料夾建立 demurrage.py:

# demurrage.py:批次計算貨櫃延滯費,並標示棄貨風險(金額單位:美元)

# ===== 計費規則(教學用假設費率)=====
FREE_DAYS = 7        # 免費期:卸船後 7 天內(含)提領不收費
TIER1_DAYS = 5       # 逾期第 1~5 天適用第一段費率
TIER1_RATE = 50.0    # 第一段:每櫃每天 USD 50
TIER2_RATE = 120.0   # 第二段(逾期第 6 天起):每櫃每天 USD 120

containers = [
    {"cntr_no": "EMCU1092384", "days": 5,  "cargo_val": 15000.0},
    {"cntr_no": "TGHU8821107", "days": 10, "cargo_val": 32000.0},
    {"cntr_no": "MSKU4401562", "days": 16, "cargo_val": 450.0},
    {"cntr_no": "OOLU9923018", "days": 14, "cargo_val": 28000.0},
    {"cntr_no": "WHLU0012847", "days": 7,  "cargo_val": 9500.0},
    {"cntr_no": "YMLU7734420", "days": -3, "cargo_val": 6000.0},
    {"cntr_no": "SITU5530912", "days": 20, "cargo_val": 800.0},
]

total_fee = 0.0      # 累加器:從 0 開始,每櫃加一次
high_risk = []       # 延滯費超過貨值的櫃號
bad_data = []        # 資料異常、無法計算的櫃號

for no, c in enumerate(containers, start=1):
    days = c["days"]

    # 防呆:天數為負代表資料有誤,記下來後跳過這一櫃
    if days < 0:
        bad_data.append(c["cntr_no"])
        continue

    overdue = max(days - FREE_DAYS, 0)          # 逾期天數,最少 0
    tier1 = min(overdue, TIER1_DAYS)            # 落在第一段的天數
    tier2 = overdue - tier1                     # 落在第二段的天數
    fee = tier1 * TIER1_RATE + tier2 * TIER2_RATE
    total_fee += fee

    if fee > c["cargo_val"]:
        status = "🚨 棄貨風險"
        high_risk.append(c["cntr_no"])
    elif fee > 0:
        status = "⚠️ 逾期"
    else:
        status = "✅ 免費期內"

    print(f"{no}. {c['cntr_no']}  停 {days:>2} 天  逾期 {overdue:>2} 天  "
          f"貨值 {c['cargo_val']:>9,.2f}  延滯費 {fee:>8,.2f}  {status}")

print("-" * 72)
print(f"延滯費合計 USD {total_fee:,.2f}")
print(f"棄貨風險 {len(high_risk)} 櫃:{', '.join(high_risk)}")
print(f"資料異常 {len(bad_data)} 櫃(未計費,請查核):{', '.join(bad_data)}")

(', '.join(清單) 把清單裡的文字用逗號串成一行。)

執行結果:

1. EMCU1092384  停  5 天  逾期  0 天  貨值 15,000.00  延滯費     0.00  ✅ 免費期內
2. TGHU8821107  停 10 天  逾期  3 天  貨值 32,000.00  延滯費   150.00  ⚠️ 逾期
3. MSKU4401562  停 16 天  逾期  9 天  貨值    450.00  延滯費   730.00  🚨 棄貨風險
4. OOLU9923018  停 14 天  逾期  7 天  貨值 28,000.00  延滯費   490.00  ⚠️ 逾期
5. WHLU0012847  停  7 天  逾期  0 天  貨值  9,500.00  延滯費     0.00  ✅ 免費期內
7. SITU5530912  停 20 天  逾期 13 天  貨值    800.00  延滯費 1,210.00  🚨 棄貨風險
------------------------------------------------------------------------
延滯費合計 USD 2,580.00
棄貨風險 2 櫃:MSKU4401562, SITU5530912
資料異常 1 櫃(未計費,請查核):YMLU7734420

第 6 筆沒有出現在明細中,因為 continue 跳過了它;但它被記在最後一行,不會無聲無息地消失。

🔍 驗收重點 - 第 4 櫃(逾期 7 天)是否為 5 × 50 + 2 × 120 = 490,而不是 7 × 120 = 840?這正是開場多算的 USD 350。 - 第 5 櫃停 7 天是否為 0(免費期含第 7 天)? - 合計 150 + 730 + 490 + 1,210 = 2,580。


伍、跑跑看、壞給你看

實驗 操作 預期結果 想想看
① 單一費率 把 fee = ... 那行改成 fee = overdue * TIER2_RATE 合計變成 USD 3,840.00,多算 1,260 這種錯誤程式不會報錯,要靠什麼抓出來?
② 拿掉防呆 刪除 if days < 0: 那三行 第 6 櫃顯示「✅ 免費期內」,資料異常變成 0 櫃 壞資料沒有讓程式當掉,而是被當成正常資料,哪個比較危險?
③ continue 誤寫成 break 把 continue 改成 break 處理到第 6 筆就結束,第 7 櫃沒算;合計 USD 1,370.00,棄貨風險只剩 1 櫃 一筆壞資料讓整批報表少算,而且最嚴重的那櫃沒被標出來
④ 無窮迴圈 在議價程式中把 price -= 1 改成 pass(什麼都不做) 程式不會結束,按 Ctrl + C 後出現 KeyboardInterrupt while 的條件裡,哪個變數一定要在迴圈中改變?

陸、回到情境

7 櫃或 70 櫃都是同一支程式、同一套規則;分段費率不會再被誤算,延滯費超過貨值的櫃子當週就會被標出,負數天數的壞資料也會留下紀錄待查。

限制 後果 在哪一節解決
計費邏輯寫在迴圈裡 報價系統、對帳系統要用同一套算法時只能複製貼上 G.5 封裝成函式
貨櫃資料寫在程式裡 每週都要改程式 第 4 章 用 pandas 讀取 Excel/CSV
不同船公司費率表不同 一套常數不夠用 把費率表做成字典(G.2),依船公司查詢

本節小結

  1. for 逐筆處理已知的一批資料;while 在條件成立時持續執行,條件裡的變數必須在迴圈中改變。
  2. 累加器(total_fee = 0.0,每筆 +=)與收集清單(.append())是批量處理最常用的兩個技巧。
  3. continue 跳過一筆、break 結束整個迴圈;跳過的資料要記錄下來,不要讓它無聲消失。
  4. 分段累進費率要拆成「各段天數 × 各段費率」,用邊界值(7 天、12 天、13 天)手算驗證。

柒、練習

  1. 改數字(5 分鐘):船公司把第二段費率調為每天 USD 150。延滯費合計變成多少?棄貨風險櫃數有沒有變?(答案:USD 3,000.00;仍為 2 櫃)
  2. 加功能(20 分鐘):主管要求統計「逾期但未達棄貨風險」的櫃數,並算出平均每櫃延滯費(只算有計費的櫃)。先寫規格(分母包含哪些櫃?),再請 AI 修改程式,最後手算驗證。
  3. 管理反思(討論):實驗 ② 和 ③ 都沒有讓程式當掉,卻讓報表悄悄出錯。如果你是營運主管,會要求在報表上加哪些「讓人一眼看出資料有問題」的資訊(例如處理筆數 = 輸入筆數?)?

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

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

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

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