E.5 企業級自動化進階:參數傳遞、輸出重定向、管線與虛擬環境

學完本節,你能夠:

  1. 用 argparse 讓 Python 程式從命令列接收參數,並對不合理的輸入停止執行、不產生結果。
  2. 用 >、>>、| 把程式結果存成檔案、累積成紀錄,或交給下一個指令篩選。
  3. 為專案建立 Python 虛擬環境(venv),並用 requirements.txt 讓同事重建相同環境。

壹、開場情境:主管的三個追問

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

小安在 E.4 跑出了 CIF 報價。主管看完提出三個要求:

  1. 「同一批貨,我想比較賣到美國、日本、歐盟的關稅成本,匯率也要能隨時換。」
  2. 「每次試算的結果要留檔,月底稽核要查得到。」
  3. 「下週新人要接手,在他的電腦上也要能跑。」

本節要解決的問題: 用四個命令列工具,分別回應這三個要求。


貳、四個工具對應三個問題

主管的要求 E.4 做法的問題 本節工具 一句話說明
隨時換市場、換匯率 數字寫死在程式裡 命令列參數(argparse) 執行時才告訴程式要用哪些數字
結果要留檔 只印在螢幕上 重新導向 >、>> 把螢幕上的文字改存進檔案
從大量結果中找重點 要用眼睛一行行找 管線 \| 把前一個指令的輸出,直接交給下一個指令處理
新人電腦也要能跑 套件版本各裝各的 虛擬環境(venv) 每個專案一套獨立的 Python 與套件

參、把規則寫下來

說法 追問 規格
「比較不同市場」 哪些市場?代碼怎麼寫? --country 只接受 US、JP、EU
「關稅怎麼算」 稅率從哪來? 放在程式最上方的 TARIFF_RATES(本節為教學用假設稅率,實務須依當期稅則與貨品分類)
「匯率要能換」 沒給匯率怎麼辦? --rate 必填,不設預設值,避免拿過期匯率做決策
(主管沒說) 輸入了清單外的市場? 停止並報錯,不用「預設 4%」之類的猜測值繼續算
(主管沒說) 金額或匯率打成 0 或負數? 停止並報錯

最後兩列和第 1.1、1.3 節的原則一致:資料不對就停下來告訴人,不要用假的數字繼續做商業判斷。


肆、讓 AI 做出來

1. 命令列參數:dynamic_tariff.py

在 TradeLab 資料夾建立:

# dynamic_tariff.py:依進口市場試算關稅與台幣總額
import argparse
from datetime import datetime

# ===== 商業規則(教學用假設稅率,不是真實稅則)=====
TARIFF_RATES = {
    "US": 0.035,
    "JP": 0.050,
    "EU": 0.065,
}

# 1. 宣告這支程式接受哪些參數
parser = argparse.ArgumentParser(description="進口關稅與台幣總額試算")
parser.add_argument("--country", required=True, choices=TARIFF_RATES.keys(),
                    help="進口市場代碼")
parser.add_argument("--price", type=float, required=True, help="貨價 (USD)")
parser.add_argument("--rate", type=float, required=True, help="美元兌台幣匯率")
args = parser.parse_args()

# 2. 防呆:金額與匯率必須是正數,否則停止,不產生報價
if args.price <= 0 or args.rate <= 0:
    parser.error("--price 與 --rate 必須大於 0")

# 3. 計算(簡化:以貨價為完稅基礎)
tariff_rate = TARIFF_RATES[args.country]
tariff_usd = args.price * tariff_rate
total_usd = args.price + tariff_usd
total_twd = total_usd * args.rate

print(f"[{datetime.now():%Y-%m-%d %H:%M}] 市場 {args.country}")
print(f"  貨價   USD {args.price:>12,.2f}")
print(f"  關稅率      {tariff_rate:>11.1%}")
print(f"  關稅   USD {tariff_usd:>12,.2f}")
print(f"  合計   USD {total_usd:>12,.2f}")
print(f"  合計   NT$ {total_twd:>12,.0f}  (匯率 {args.rate})")

執行(Windows 用 python,macOS 用 python3;啟用第 5 小節的虛擬環境後兩邊都用 python):

python dynamic_tariff.py --country US --price 50000 --rate 32.4
[2026-10-05 14:06] 市場 US
  貨價   USD    50,000.00
  關稅率             3.5%
  關稅   USD     1,750.00
  合計   USD    51,750.00
  合計   NT$    1,676,700  (匯率 32.4)

輸入 python dynamic_tariff.py --help,argparse 會依程式中的 help 文字自動產生使用說明。

🔍 驗收重點 - 稅率是否集中在最上方的 TARIFF_RATES? - 清單外的市場、缺少匯率、負數金額,是否都會停止而不是算出一個數字?

2. 一次比較三個市場

兩個 Shell 的迴圈寫法不同,結果相同:

# Windows PowerShell
foreach ($c in "US", "JP", "EU") { python dynamic_tariff.py --country $c --price 50000 --rate 32.4 }
# macOS zsh
for c in US JP EU; do python3 dynamic_tariff.py --country $c --price 50000 --rate 32.4; done

三個市場的台幣合計分別是 NT$ 1,676,700、1,701,000、1,725,300。

3. 重新導向:> 覆寫、>> 附加

# 覆寫:存成報價檔(檔案已存在就整個蓋掉)
python dynamic_tariff.py --country US --price 80000 --rate 32.4 > quote_US.txt

# 附加:接在檔案最後面,累積成稽核紀錄
python dynamic_tariff.py --country US --price 80000 --rate 32.4 >> audit.log
python dynamic_tariff.py --country US --price 80000 --rate 32.8 >> audit.log

這三行在兩個系統寫法完全相同(macOS 未啟用虛擬環境時請用 python3)。執行時螢幕不會顯示結果,因為輸出都進了檔案。程式每次都會印出試算時間,所以 audit.log 就是一份有時間戳的紀錄。

⚠️ > 和 >> 只差一個字元,後果差很多 對稽核紀錄誤用 >,之前累積的紀錄會被整個覆蓋,而且無法復原。

4. 管線:把結果交給下一個指令

只想看台幣合計那一行:

# Windows PowerShell
python dynamic_tariff.py --country EU --price 50000 --rate 32.4 | Select-String "NT"
Get-Content audit.log | Select-String "NT"
# macOS zsh
python3 dynamic_tariff.py --country EU --price 50000 --rate 32.4 | grep "NT"
grep "NT" audit.log

audit.log 的篩選結果:

  合計   NT$    2,682,720  (匯率 32.4)
  合計   NT$    2,715,840  (匯率 32.8)

匯率從 32.4 升到 32.8,同一批貨的台幣金額多了 NT$ 33,120。

💡 Windows 若在存檔或管線時出現中文亂碼,請回到 E.2 第陸段完成 UTF-8 設定。

5. 虛擬環境:每個專案一套獨立的套件

假設專案 A 兩年前用 pandas 1.x 開發,專案 B 要用 pandas 2.x。如果都裝在同一個 Python 裡,裝了新版,舊專案就可能壞掉。虛擬環境(venv) 讓每個專案資料夾有自己的一套 Python 與套件。

步驟 Windows PowerShell macOS zsh
① 建立(在 TradeLab 裡執行一次) python -m venv venv python3 -m venv venv
② 啟用 .\venv\Scripts\Activate.ps1 source venv/bin/activate
③ 安裝套件 pip install requests pip install requests
④ 匯出清單 pip freeze > requirements.txt pip freeze > requirements.txt
⑤ 新人重建環境 ①② 之後執行 pip install -r requirements.txt 同左
⑥ 離開 deactivate deactivate

啟用成功時,提示字元最前面會出現 (venv):

(venv) PS C:\Users\anan\Desktop\TradeLab>      ← Windows
(venv) anan@MacBook TradeLab %                 ← macOS

啟用後,兩個系統都可以直接用 python 和 pip,裝的套件只存在 TradeLab/venv 裡。Windows 在步驟 ② 出現紅字,代表 E.2 第肆段的 ExecutionPolicy 還沒設定。

步驟 ④ 產生的 requirements.txt 長這樣(版本號依安裝時間而異):

# 版本號為示意,請以實際 pip freeze 結果為準
certifi==2026.7.22
charset-normalizer==3.5.2
idna==3.20
requests==2.34.2
urllib3==2.8.0

只裝了 requests 一個套件,清單卻有五行——其他四個是 requests 自己需要的套件,pip 會一併記錄版本。這正是「在我電腦可以跑」問題的根源:你以為只裝了一樣東西,實際上依賴了一整串。

💡 venv 資料夾很大,而且只能在建立它的那台電腦使用。交給同事或放進版本控制(附錄 A)的是 requirements.txt,不是 venv 資料夾。


伍、跑跑看、壞給你看

實驗 操作 預期結果 想想看
① 清單外的市場 --country DE error: argument --country: invalid choice: 'DE',不產生任何報價 德國屬於歐盟關稅同盟,應該用 EU。如果程式默默用「預設 4%」算下去,會發生什麼事?
② 小寫代碼 --country us 同樣被拒絕 要改成接受小寫嗎?改的話規格表要怎麼寫?
③ 忘了給匯率 拿掉 --rate 32.4 error: the following arguments are required: --rate 為什麼匯率故意不設預設值?
④ 錯誤訊息存不進檔案 python dynamic_tariff.py --country XX --price 1 --rate 1 > err.txt 錯誤訊息仍顯示在螢幕上,err.txt 是空的 程式的「正常輸出」和「錯誤訊息」走不同管道,所以出錯時不會被悄悄藏進檔案裡
⑤ 覆寫 vs. 附加 對 audit.log 用 >> 執行兩次,再用 > 執行一次 兩次 >> 後有 12 行;一次 > 後只剩 6 行 稽核紀錄應該由誰、用什麼方式寫入,才不會被誤蓋?

陸、回到情境

三個要求現在分別由「迴圈+參數」、「>> 寫入有時間戳的 audit.log」、「dynamic_tariff.py + requirements.txt」解決。

這個做法仍有限制:

限制 後果 在哪裡解決
匯率仍要人工輸入 打錯一位數,紀錄裡就是錯的 第 1.3 節:連網抓匯率,失敗就停止告警
audit.log 是一般文字檔,誰都能改 稽核紀錄可能被竄改 附錄 A:用 Git 留下修改軌跡;第 9 章:權限與內部控制
每次都要人來執行 忘了跑就沒紀錄 第 6 章:排程與自動化部署

本附錄學到的環境、路徑、Python 執行方式,後面會一直用到:附錄 A 的 Git 指令、第 4 章與附錄 G 的 Python 程式、附錄 B 的 Google Antigravity,以及 B.8 在終端機中執行的 Claude Code,都建立在這些基礎上。

本節小結

  1. 會變的商業參數(市場、匯率、金額)從命令列傳入,不寫死在程式裡;不合理的輸入就停止,不猜。
  2. > 覆寫、>> 附加;稽核紀錄只能用 >>。
  3. | 把前一個指令的輸出交給下一個指令,Windows 用 Select-String,macOS 用 grep。
  4. 每個專案一個 venv;交付的是 requirements.txt,不是 venv 資料夾。

柒、練習

  1. 改數字(5 分鐘):日本調整稅率為 6%。你要改哪一行?改完後用 --country JP --price 50000 --rate 32.4 執行,台幣合計是多少?(答案:NT$ 1,717,200)
  2. 加功能(20 分鐘):請 AI 為程式加上 --qty(數量,必須是正整數)參數,貨價改為「單價 × 數量」。先更新第參段的規格表(含例外),再寫 Prompt;完成後用實驗 ①~③ 的方式測試 --qty 0 與 --qty 2.5。
  3. 管理反思(討論):TARIFF_RATES 寫在程式裡,稅率調整時需要有人改程式。另一種做法是把稅率放在一份由關務人員維護的試算表。請比較兩種做法在更新速度、出錯風險、責任歸屬上的差異。

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

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

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

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