G.2 容器與資料結構:List、Dict、Set 在採購清單與客戶名錄的應用

學完本節,你能夠:

  1. 依資料特性選用 list、tuple、dict、set,並說出選擇理由。
  2. 用 dict 查詢商品主檔、依品號加總數量,並在查不到資料時停下來告警,而不是套用猜測值。
  3. 用 set 去除重複名單、找出「報了價還沒下單」的客戶。

壹、開場情境:三家分店、七筆請購、一個查不到的品號

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

小安的公司有台北、台中、高雄三家分店,每月各自提報進口零件的請購單。總部要把請購合併成一張進口訂單,並預估要繳多少關稅。

過去的做法是把三張 Excel 貼在一起,用眼睛找相同品號、手動加總、再一個個查關稅率。這個月出了兩個問題:

  • 同一個品號被兩家分店提報,合併時漏加了一筆,少訂了 10 件。
  • 高雄提報了一個新品號 SKU-05,商品主檔裡還沒建檔,承辦人隨手用「大概 5%」估關稅。

本節要解決的問題: G.1 的變數一次只裝一個值;面對一整批資料,要用什麼容器裝?怎麼做到「查得到就算,查不到就停下來說」?


貳、四種容器:各有各的用途

容器 寫法 特性 外貿比喻
list 清單 [a, b, c] 有順序、可修改、可重複 裝箱單:一櫃一櫃照順序列
tuple 元組 (a, b) 有順序、建立後不能改 一筆已確認的請購:(分店, 品號, 數量)
dict 字典 {鍵: 值} 用「鍵」直接查「值」,鍵不重複 商品主檔、關稅率表
set 集合 {a, b} 或 set() 不重複、沒有固定順序 去除重複的名片名單

1. list:有順序的清單

Python 的位置編號(索引)從 0 開始:

# 一批要裝船的貨櫃號碼
containers = ["TGHU1029384", "EMCU8841102", "MSKU3392055", "OOLU5510736"]

print(containers[0])      # 第一櫃
print(containers[-1])     # 最後一櫃(負數從後面數)
print(containers[1:3])    # 第 2、3 櫃(含 1,不含 3)

containers.append("WHLU0012847")   # 臨時加一櫃
print(len(containers))             # 總櫃數
TGHU1029384
OOLU5510736
['EMCU8841102', 'MSKU3392055']
5

2. tuple:確認後不能改的一筆紀錄

order_line = ("SKU-01", 20)     # (品號, 數量)
sku, qty = order_line           # 一次拆成兩個變數
print(sku, qty)
order_line[1] = 30              # 想偷改數量
SKU-01 20
Traceback (most recent call last):
  ...(中間顯示出錯的行號,略)
TypeError: 'tuple' object does not support item assignment

已經確認的紀錄用 tuple 存,誤改時程式會直接報錯。

3. dict:用鍵查值

# 進口關稅率表(教學用假設稅率,與 E.5 相同)
TARIFF_RATES = {"US": 0.035, "JP": 0.050, "EU": 0.065}

print(TARIFF_RATES["JP"])               # 用「鍵」直接查「值」
print(f"{TARIFF_RATES['EU']:.1%}")

TARIFF_RATES["UK"] = 0.040              # 新增一個市場
print("UK" in TARIFF_RATES)             # 查某個鍵在不在
print(TARIFF_RATES.get("BR"))           # 查不到時回傳 None,不會當掉
0.05
6.5%
True
None

如果寫 TARIFF_RATES["BR"],程式會停在 KeyError: 'BR'。

⚠️ .get() 的預設值不能拿來猜稅率 .get("BR", 0.05) 語法上可以在查不到時回傳 5%,但這等於拿一個沒人核准的數字做商業判斷——就是開場高雄那筆的錯誤。稅率、匯率這類數字,查不到就應該停下來告訴人(E.5 也是同樣原則)。.get(鍵, 0) 適合用在「從 0 開始累加」這種預設值本身就正確的地方,下面的程式會看到。

dict 不論有幾筆資料,用鍵查詢都一樣快;list 則要從頭一筆筆比對。商品主檔有上萬筆時,差別就很明顯。

4. set:去重複與比對名單

# 展會收到的名片(同一家公司被登記了好幾次)
leads = ["Bosch", "Siemens", "Miele", "Bosch", "Festo", "Siemens"]
unique_leads = set(leads)
print(len(leads), len(unique_leads))

# 已報價、已下單的客戶
quoted = {"Bosch", "Siemens", "Miele", "Festo"}
ordered = {"Bosch", "Miele"}
print(sorted(quoted - ordered))   # 差集:報了價還沒下單 → 業務要追
print(sorted(quoted & ordered))   # 交集:報價且已下單
6 4
['Festo', 'Siemens']
['Bosch', 'Miele']

set 沒有固定順序,所以要給人看時用 sorted() 排好。


參、把規則寫下來:請購彙總

主管說的話 需要追問 寫成規格
「把三家的請購合起來」 同品號怎麼處理? 依 SKU 加總數量(不是刪掉重複)
「算一下關稅」 稅率從哪裡來? 一律查商品主檔 CATALOG,關稅 = 貨值 × 稅率
「整批稅負多少」 用哪種平均? 有效關稅率 = 關稅合計 ÷ 貨值合計(依金額加權)
(主管沒說) 主檔查不到的品號? 不列入合計,另外列出分店與品號,請先補建主檔
(主管沒說) 報表順序? 依 SKU 排序

肆、寫出來

💡 程式用到 for(對清單中每一筆做一次)與 if(條件判斷),分別在 G.4、G.3 詳細說明;這裡先看懂容器怎麼用即可。

在 TradeLab 資料夾建立 purchase_summary.py:

# purchase_summary.py:彙整各分店請購單,試算進口關稅

# ===== 商品主檔:SKU → 品名、美元單價、關稅率(教學用假設值)=====
CATALOG = {
    "SKU-01": {"name": "鋰電池組", "price": 450.0, "tariff": 0.06},
    "SKU-02": {"name": "無刷馬達", "price": 120.0, "tariff": 0.04},
    "SKU-03": {"name": "控制主板", "price": 320.0, "tariff": 0.02},
    "SKU-04": {"name": "鋁製框架", "price": 85.0, "tariff": 0.08},
}

# 各分店請購明細:每筆是 (分店, SKU, 數量) 的 tuple
requests = [
    ("台北", "SKU-01", 20),
    ("台中", "SKU-03", 15),
    ("台北", "SKU-02", 40),
    ("高雄", "SKU-01", 10),
    ("台中", "SKU-04", 60),
    ("高雄", "SKU-02", 25),
    ("高雄", "SKU-05", 8),
]

all_skus = set()   # 出現過的 SKU(自動去除重複)
total_qty = {}     # SKU → 合計數量
unknown = []       # 主檔查不到的請購

# 對清單中的每一筆請購做一次(for 迴圈見 G.4)
for branch, sku, qty in requests:
    all_skus.add(sku)
    if sku in CATALOG:
        total_qty[sku] = total_qty.get(sku, 0) + qty   # 第一次出現從 0 開始加
    else:
        unknown.append((branch, sku))

print(f"請購 {len(requests)} 筆,不重複品項 {len(all_skus)} 種")
print("-" * 52)

total_value = 0.0
total_tariff = 0.0
for sku in sorted(total_qty):
    item = CATALOG[sku]
    value = total_qty[sku] * item["price"]
    tariff = value * item["tariff"]
    total_value += value
    total_tariff += tariff
    print(f"{sku}  {item['name']:<6}{total_qty[sku]:>5} 件  "
          f"貨值 {value:>10,.2f}  關稅 {tariff:>8,.2f}")

print("-" * 52)
print(f"貨值合計 USD {total_value:,.2f}")
print(f"關稅合計 USD {total_tariff:,.2f}")
print(f"整批有效關稅率 {total_tariff / total_value:.2%}")

for branch, sku in unknown:
    print(f"⚠️ 主檔查無 {sku}({branch}),未列入合計,請先補建主檔")

執行結果:

請購 7 筆,不重複品項 5 種
----------------------------------------------------
SKU-01  鋰電池組     30 件  貨值  13,500.00  關稅   810.00
SKU-02  無刷馬達     65 件  貨值   7,800.00  關稅   312.00
SKU-03  控制主板     15 件  貨值   4,800.00  關稅    96.00
SKU-04  鋁製框架     60 件  貨值   5,100.00  關稅   408.00
----------------------------------------------------
貨值合計 USD 31,200.00
關稅合計 USD 1,626.00
整批有效關稅率 5.21%
⚠️ 主檔查無 SKU-05(高雄),未列入合計,請先補建主檔

🔍 驗收重點 - SKU-01 是否為台北 20 + 高雄 10 = 30 件?SKU-02 是否為 40 + 25 = 65 件? - 關稅合計 810 + 312 + 96 + 408 = 1,626;1,626 ÷ 31,200 = 5.21%。 - SKU-05 有沒有被列出來,而不是被悄悄忽略或套用猜測稅率?


伍、跑跑看、壞給你看

實驗 操作 預期結果 想想看
① 拿掉主檔檢查 把 if sku in CATALOG: 改成 if True: 印出標題與 SKU-01~04 各列後,到 SKU-05 停在 KeyError: 'SKU-05':印到一半當掉,合計沒有出來 停下來和列出例外,哪一種對承辦人比較友善?
② 不用 .get() 累加 把 total_qty.get(sku, 0) + qty 改成 total_qty[sku] + qty KeyError: 'SKU-01' 第一次遇到某品號時,字典裡還沒有它
③ 用簡單平均 在 REPL 算 (0.06 + 0.04 + 0.02 + 0.08) / 4 0.05,即 5.00%,和加權的 5.21% 不同 稅率高的 SKU-01 貨值最大,簡單平均低估了稅負
④ set 的順序 連續執行三次 print(set(leads)) 每次印出的順序可能不同 為什麼報表輸出前要先 sorted()?

陸、回到情境

合併請購改由程式依 SKU 加總,不會再漏加;新品號 SKU-05 被明確列為例外,承辦人得先補建主檔、確認稅率,不能再用「大概 5%」。

限制 後果 在哪一節解決
請購數量是 0 或負數也照算 訂單數量被抵銷而不自知 G.3 條件判斷與防呆
主檔與請購寫在程式裡 每月都要改程式 第 4 章 用 pandas 讀 Excel/CSV
稅率是假設值 不能直接拿來報關 實務須依當期稅則與貨品分類(HS Code)查定

本節小結

  1. list 有順序、可修改;tuple 確認後不能改;dict 用鍵查值;set 自動去除重複。
  2. 「合併重複」要先想清楚是刪掉重複(名單,用 set)還是加總數量(請購,用 dict)。
  3. .get(鍵, 0) 適合累加計數;稅率、匯率查不到就要停下來告警,不用猜測值。
  4. 整批稅負用金額加權,不用稅率的簡單平均。

柒、練習

  1. 改數字(5 分鐘):SKU-04 的關稅率調高為 10%。關稅合計與整批有效關稅率變成多少?(答案:USD 1,728.00;5.54%)
  2. 加功能(20 分鐘):主管想知道每家分店的請購貨值。先寫規格(用哪種容器、鍵和值各是什麼、查不到的品號怎麼處理),再請 AI 修改程式,並驗算三家分店貨值加總是否等於 31,200。
  3. 管理反思(討論):開場承辦人用「大概 5%」估關稅,是想讓工作繼續做下去。「先估一個數字讓流程不中斷」與「停下來等主檔補齊」各有什麼代價?誰應該負責維護商品主檔?

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

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

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

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