G.1 變數與資料型態:外貿報價與發票數據建立型態意識

學完本節,你能夠:

  1. 用 snake_case 為商業數據取出看得懂的變數名稱,並說明 = 在程式中的意思。
  2. 分辨 int、float、str、bool 四種型態,並用 int()、float() 把表單讀進來的文字轉成數字。
  3. 用 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 命令列參數

本節小結

  1. 變數是貼了名稱的貨櫃;= 是「把右邊放進左邊」,名稱用 snake_case、見名知意。
  2. 數量用 int,金額、匯率用 float,文字用 str,是/否用 bool。
  3. 表單與檔案讀進來的常是字串,計算前要先轉型;字串的 + 是拼接。
  4. 金額輸出用 f-string 指定千分位與小數位,並和手算核對。

柒、練習

  1. 改數字(5 分鐘):數量改成 "120"、匯率改成 31.85。發票總額與台幣金額各是多少?(答案:USD 15,125.00;NT$ 481,731)
  2. 加功能(20 分鐘):買家要求給 3% 樣品折扣(只折貨款,不折手續費)。先寫出規格(折扣參數名稱、折在哪一項、輸出多哪一行),再請 AI 修改程式,最後手算驗證發票總額。
  3. 管理反思(討論):實驗 ① 會報錯、開場的拼接卻不會。對公司來說,「程式當掉」和「程式算錯但沒人發現」哪一個成本比較高?你會希望系統在什麼情況下主動停下來?

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

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

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

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