E.5 企業級自動化進階:參數傳遞、輸出重定向、管線與虛擬環境
學完本節,你能夠:
- 用
argparse讓 Python 程式從命令列接收參數,並對不合理的輸入停止執行、不產生結果。 - 用
>、>>、|把程式結果存成檔案、累積成紀錄,或交給下一個指令篩選。 - 為專案建立 Python 虛擬環境(venv),並用
requirements.txt讓同事重建相同環境。
壹、開場情境:主管的三個追問
📌 以下為教學情境(依實務改編)。
小安在 E.4 跑出了 CIF 報價。主管看完提出三個要求:
- 「同一批貨,我想比較賣到美國、日本、歐盟的關稅成本,匯率也要能隨時換。」
- 「每次試算的結果要留檔,月底稽核要查得到。」
- 「下週新人要接手,在他的電腦上也要能跑。」
本節要解決的問題: 用四個命令列工具,分別回應這三個要求。
貳、四個工具對應三個問題
| 主管的要求 | 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,都建立在這些基礎上。
本節小結
- 會變的商業參數(市場、匯率、金額)從命令列傳入,不寫死在程式裡;不合理的輸入就停止,不猜。
>覆寫、>>附加;稽核紀錄只能用>>。|把前一個指令的輸出交給下一個指令,Windows 用Select-String,macOS 用grep。- 每個專案一個 venv;交付的是
requirements.txt,不是venv資料夾。
柒、練習
- 改數字(5 分鐘):日本調整稅率為 6%。你要改哪一行?改完後用
--country JP --price 50000 --rate 32.4執行,台幣合計是多少?(答案:NT$ 1,717,200) - 加功能(20 分鐘):請 AI 為程式加上
--qty(數量,必須是正整數)參數,貨價改為「單價 × 數量」。先更新第參段的規格表(含例外),再寫 Prompt;完成後用實驗 ①~③ 的方式測試--qty 0與--qty 2.5。 - 管理反思(討論):
TARIFF_RATES寫在程式裡,稅率調整時需要有人改程式。另一種做法是把稅率放在一份由關務人員維護的試算表。請比較兩種做法在更新速度、出錯風險、責任歸屬上的差異。