G.2 容器與資料結構:List、Dict、Set 在採購清單與客戶名錄的應用
學完本節,你能夠:
- 依資料特性選用 list、tuple、dict、set,並說出選擇理由。
- 用 dict 查詢商品主檔、依品號加總數量,並在查不到資料時停下來告警,而不是套用猜測值。
- 用 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)查定 |
本節小結
- list 有順序、可修改;tuple 確認後不能改;dict 用鍵查值;set 自動去除重複。
- 「合併重複」要先想清楚是刪掉重複(名單,用 set)還是加總數量(請購,用 dict)。
.get(鍵, 0)適合累加計數;稅率、匯率查不到就要停下來告警,不用猜測值。- 整批稅負用金額加權,不用稅率的簡單平均。
柒、練習
- 改數字(5 分鐘):SKU-04 的關稅率調高為 10%。關稅合計與整批有效關稅率變成多少?(答案:USD 1,728.00;5.54%)
- 加功能(20 分鐘):主管想知道每家分店的請購貨值。先寫規格(用哪種容器、鍵和值各是什麼、查不到的品號怎麼處理),再請 AI 修改程式,並驗算三家分店貨值加總是否等於 31,200。
- 管理反思(討論):開場承辦人用「大概 5%」估關稅,是想讓工作繼續做下去。「先估一個數字讓流程不中斷」與「停下來等主檔補齊」各有什麼代價?誰應該負責維護商品主檔?