G.4 迴圈與批量處理:for / while 在多筆貨櫃迭代與延滯費計算
學完本節,你能夠:
- 用
for搭配enumerate()、.items()逐筆處理清單與字典,並用累加器算出總額。 - 用
while處理「不知道要做幾次、只知道何時停」的問題,並避免無窮迴圈。 - 用
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),依船公司查詢 |
本節小結
for逐筆處理已知的一批資料;while在條件成立時持續執行,條件裡的變數必須在迴圈中改變。- 累加器(
total_fee = 0.0,每筆+=)與收集清單(.append())是批量處理最常用的兩個技巧。 continue跳過一筆、break結束整個迴圈;跳過的資料要記錄下來,不要讓它無聲消失。- 分段累進費率要拆成「各段天數 × 各段費率」,用邊界值(7 天、12 天、13 天)手算驗證。
柒、練習
- 改數字(5 分鐘):船公司把第二段費率調為每天 USD 150。延滯費合計變成多少?棄貨風險櫃數有沒有變?(答案:USD 3,000.00;仍為 2 櫃)
- 加功能(20 分鐘):主管要求統計「逾期但未達棄貨風險」的櫃數,並算出平均每櫃延滯費(只算有計費的櫃)。先寫規格(分母包含哪些櫃?),再請 AI 修改程式,最後手算驗證。
- 管理反思(討論):實驗 ② 和 ③ 都沒有讓程式當掉,卻讓報表悄悄出錯。如果你是營運主管,會要求在報表上加哪些「讓人一眼看出資料有問題」的資訊(例如處理筆數 = 輸入筆數?)?