G.1 變數與資料型態:外貿報價與發票數據建立型態意識
學完本節,你能夠:
- 用 snake_case 為商業數據取出看得懂的變數名稱,並說明
=在程式中的意思。 - 分辨
int、float、str、bool四種型態,並用int()、float()把表單讀進來的文字轉成數字。 - 用 f-string 把金額印成千分位、小數兩位的發票格式,並與手算結果核對。
壹、開場情境:120 美元變成 10020
📌 以下為教學情境(依實務改編)。
小安在 E.4 學會了執行 Python 腳本。這次主管請她寫一支小程式,把網頁詢價表單上的「貨價」與「運費」加總。她寫了:
price = "100"
shipping = "20"
total = price + shipping
print(f"總金額為: {total}")
執行結果:
總金額為: 10020
程式沒有報錯,算出來的卻是一個離譜的數字。如果這個結果直接寫進報價單,客戶會收到一張「USD 10,020」的報價。
本節要解決的問題: 電腦怎麼存放商業數據?為什麼同樣是「100」,有時能加、有時只能拼接?
貳、為什麼會這樣:變數與資料型態
1. 變數是貼了標籤的貨櫃
| 程式概念 | 外貿比喻 | 範例 |
|---|---|---|
| 變數名稱 | 貨櫃外的標籤 | unit_price |
| 值 | 貨櫃裡的貨 | 125.50 |
指定 = |
把貨裝進貨櫃 | unit_price = 125.50 |
= 在程式裡不是數學的「等於」,而是「把右邊的值,放進左邊的變數」。所以 count = count + 1 在數學上不成立,在程式裡卻很常見:把 count 原本的值加 1,再放回 count。
變數名稱要讓接手的同事一看就懂。Python 慣用 snake_case:全部小寫,單字之間用底線連接。
| ❌ 看不懂 | ✅ 見名知意 |
|---|---|
a = 100 |
fob_price = 100.0 |
t = 0.05 |
tariff_rate = 0.05 |
x1 = "US" |
destination_country = "US" |
2. 四種基本資料型態
| 型態 | Python 名稱 | 商業範例 | 說明 |
|---|---|---|---|
| 整數 | int |
order_units = 500 |
沒有小數點:箱數、件數 |
| 浮點數 | float |
unit_price_eur = 112.0 |
有小數點:單價、匯率、費率 |
| 字串 | str |
sku_code = "KB-ERGO-A" |
文字、代碼;用引號包起來 |
| 布林 | bool |
is_lc_payment = True |
只有 True/False 兩種狀態 |
用 type() 可以查變數的型態:
sku_code = "KB-ERGO-A" # str:產品型號
order_units = 500 # int:訂購數量(把)
unit_price_eur = 112.0 # float:歐元單價
is_lc_payment = True # bool:是否以信用狀付款
print(type(order_units))
print(type(unit_price_eur))
print(type(sku_code))
print(type(is_lc_payment))
<class 'int'>
<class 'float'>
<class 'str'>
<class 'bool'>
3. 開場的錯誤:字串的 + 是拼接
"100" 有引號,是字串。字串相加是把文字接在一起("100" + "20" → "10020"),不是數學加法。網頁表單、CSV、Excel 匯出的資料,常常整欄都是字串,所以計算前要先轉換型態:
| 函式 | 作用 | 範例 |
|---|---|---|
int() |
轉成整數 | int("80") → 80 |
float() |
轉成浮點數 | float("125.50") → 125.5 |
str() |
轉成字串 | str(120) → "120" |
參、把規則寫下來:形式發票試算
歐洲買家要求先開一張樣品的形式發票(Proforma Invoice, PI:正式出貨前給買家確認金額的發票)。
| 主管說的話 | 需要追問 | 寫成規格 |
|---|---|---|
| 「數量從表單抓」 | 表單給的是數字還是文字? | 以字串讀入,先用 int() 轉換再計算 |
| 「單價 125.5 美元」 | 能不能用整數存? | 不行,單價、匯率一律用 float |
| 「加上手續費」 | 手續費按件還是按單? | 每張發票固定 USD 65 |
| 「順便換成台幣」 | 用哪個匯率?到幾位? | 匯率 32.20 寫在最上方;台幣四捨五入到整數 |
| 「要看起來專業」 | 金額格式? | 千分位、美元小數兩位 |
肆、寫出來
1. 最小必要概念:f-string 格式化
在引號前加 f,就能在 {} 裡放變數或算式;冒號後面控制格式:
| 寫法 | 意思 | 範例結果 |
|---|---|---|
{x:,.2f} |
千分位、小數兩位 | 56,000.00 |
{x:,.0f} |
千分位、四捨五入到整數 | 325,381 |
{x:>10,.2f} |
靠右對齊、佔 10 格 | 10,040.00 |
{x:.1%} |
乘以 100 加 %,一位小數 |
11.1% |
item = "人體工學鍵盤 A 款"
qty = 500
eur_price = 112.0
print(f"品名: {item} | 數量: {qty} 把 | 總價: €{qty * eur_price:,.2f}")
品名: 人體工學鍵盤 A 款 | 數量: 500 把 | 總價: €56,000.00
2. 程式碼
在 TradeLab 資料夾建立 proforma_invoice.py:
# proforma_invoice.py:形式發票試算(金額單位:美元)
# ===== 交易參數(改數字只要改這幾行)=====
PRODUCT_NAME = "工業級物聯網感測模組"
QTY_TEXT = "80" # 從網頁表單讀進來的數量,是字串
UNIT_PRICE_USD = 125.50 # FOB 單價
HANDLING_FEE_USD = 65.00 # 樣品快遞與文件手續費
USD_TWD = 32.20 # 美元兌台幣匯率
# 型別轉換:字串 → 整數,才能拿來乘
qty = int(QTY_TEXT)
goods_usd = qty * UNIT_PRICE_USD
total_usd = goods_usd + HANDLING_FEE_USD
total_twd = total_usd * USD_TWD
print("=" * 40)
print("形式發票 PROFORMA INVOICE")
print("=" * 40)
print(f"品名 : {PRODUCT_NAME}")
print(f"數量 : {qty} PCS")
print(f"單價 : USD {UNIT_PRICE_USD:>10,.2f}")
print(f"貨款小計 : USD {goods_usd:>10,.2f}")
print(f"手續費 : USD {HANDLING_FEE_USD:>10,.2f}")
print("-" * 40)
print(f"發票總額 : USD {total_usd:>10,.2f}")
print(f"約合台幣 : NT$ {total_twd:>10,.0f}(匯率 {USD_TWD})")
執行 python proforma_invoice.py(macOS:python3):
========================================
形式發票 PROFORMA INVOICE
========================================
品名 : 工業級物聯網感測模組
數量 : 80 PCS
單價 : USD 125.50
貨款小計 : USD 10,040.00
手續費 : USD 65.00
----------------------------------------
發票總額 : USD 10,105.00
約合台幣 : NT$ 325,381(匯率 32.2)
🔍 驗收重點 - 手算:80 × 125.5 = 10,040;+65 = 10,105;× 32.2 = 325,381。三個數字都對得上嗎? - 參數是否都在最上方,名稱看得懂? - 最後一行的匯率印成
32.2而不是32.20:數值沒變,只是沒指定格式。想印成32.20,要寫成{USD_TWD:.2f}。
伍、跑跑看、壞給你看
| 實驗 | 操作 | 預期結果 | 想想看 |
|---|---|---|---|
| ① 忘了轉型 | 把 qty = int(QTY_TEXT) 改成 qty = QTY_TEXT |
TypeError: can't multiply sequence by non-int of type 'float' |
這次 Python 有報錯,開場的 "100" + "20" 卻沒有。哪一種比較危險? |
| ② 表單多打了單位 | 把 QTY_TEXT 改成 "80 PCS" |
ValueError: invalid literal for int() with base 10: '80 PCS' |
程式停下來,總比算出錯的金額好 |
| ③ 單價被存成整數 | 在 REPL 算 int(125.50) * 80 |
10000,比正確的 10,040 少 USD 40 |
int() 是直接捨去小數,不是四捨五入 |
| ④ 小數的誤差 | 在 REPL 輸入 0.1 + 0.2 |
0.30000000000000004 |
所以金額輸出一律指定小數位數;正式會計系統會改用 decimal 模組 |
陸、回到情境
小安把表單讀進來的數字先用 int()、float() 轉換,報價單上的 10020 不會再出現;就算表單內容不是數字,程式也會報錯停下,而不是悄悄算錯。
| 限制 | 後果 | 在哪一節解決 |
|---|---|---|
| 一次只能處理一個產品 | 10 個品項就要寫 10 組變數 | G.2 用清單與字典裝整批資料 |
| 數量打錯(例如 0 或負數)照樣計算 | 開出金額為 0 或負的發票 | G.3 用 if 檢查並停止 |
| 參數仍寫在程式裡 | 每張發票都要改程式 | E.5 命令列參數 |
本節小結
- 變數是貼了名稱的貨櫃;
=是「把右邊放進左邊」,名稱用 snake_case、見名知意。 - 數量用
int,金額、匯率用float,文字用str,是/否用bool。 - 表單與檔案讀進來的常是字串,計算前要先轉型;字串的
+是拼接。 - 金額輸出用 f-string 指定千分位與小數位,並和手算核對。
柒、練習
- 改數字(5 分鐘):數量改成
"120"、匯率改成 31.85。發票總額與台幣金額各是多少?(答案:USD 15,125.00;NT$ 481,731) - 加功能(20 分鐘):買家要求給 3% 樣品折扣(只折貨款,不折手續費)。先寫出規格(折扣參數名稱、折在哪一項、輸出多哪一行),再請 AI 修改程式,最後手算驗證發票總額。
- 管理反思(討論):實驗 ① 會報錯、開場的拼接卻不會。對公司來說,「程式當掉」和「程式算錯但沒人發現」哪一個成本比較高?你會希望系統在什麼情況下主動停下來?