E.4 Python 程式在終端機的執行實戰:REPL 對話模式與腳本執行模式

學完本節,你能夠:

  1. 用 PATH 的概念解釋 command not found 類錯誤,並在 Windows 與 macOS 上確認 Python 已可使用。
  2. 用 REPL 模式做即時試算,並正確離開 REPL。
  3. 在專案資料夾中執行一支 Python 腳本,修改最上方的參數後重新執行並驗算結果。

壹、開場情境:AI 寫好了程式,卻跑不起來

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

小安請 AI 寫了一支把 FOB 報價換算成 CIF 報價的程式,存成 cif_quotation.py,放進 E.3 建好的 TradeLab 資料夾。她在終端機輸入 python cif_quotation.py,結果:

系統 看到的畫面
Windows 跳出 Microsoft Store 的 Python 頁面,或出現 The term 'python' is not recognized as a name of a cmdlet, function, script file, or executable program.
macOS zsh: command not found: python

本節要解決的問題: 讓電腦找得到 Python,並學會兩種執行 Python 的方式:邊打邊算的 REPL,以及一次跑完的腳本。


貳、為什麼會找不到:PATH 環境變數

你輸入 python 時,作業系統不會把整顆硬碟翻一遍,而是只去一份登記好的資料夾清單裡找,這份清單叫做 PATH。就像總機只會查內線分機表:沒登記的人,就算在公司裡也轉接不到。

flowchart LR A["輸入 python"] --> B{"PATH 清單中的資料夾
有沒有 python?"} B -->|"有"| C["啟動 Python"] B -->|"沒有"| D["not recognized /
command not found"]
系統 常見原因 解法
Windows 沒裝 Python,系統改開 Microsoft Store(「應用程式執行別名」) 到 python.org 下載安裝
Windows 安裝時沒勾 Add python.exe to PATH 重新執行安裝程式勾選;或改用 py 指令(python.org 安裝程式會一併裝好 py 啟動器)
macOS macOS 的 Python 指令叫 python3,本來就沒有 python 改輸入 python3;若跳出安裝「命令列開發者工具」的視窗,依指示安裝,或到 python.org 下載安裝
兩者 剛裝完 Python,終端機還開著舊視窗 關掉終端機重開,PATH 才會重新讀取

💡 較新版的 python.org Windows 安裝方式改用 Python 安裝管理員(py 指令),傳統安裝程式也可能不再出現「Add python.exe to PATH」勾選框。遇到這種情況,請把本書的 python 改打 py。

想看看自己的 PATH 清單和 Python 的位置:

# Windows PowerShell
$env:Path -split ';'
Get-Command python
# macOS zsh
echo $PATH | tr ':' '\n'
which python3

確認版本

系統 指令 正常結果
Windows python --version(或 py --version) Python 3.12 以上的版本
macOS python3 --version 同上

💡 本節以下的指令,Windows 寫 python,macOS 請一律換成 python3。E.5 啟用虛擬環境後,兩邊都可以只打 python。


參、模式一:REPL,邊打邊算

REPL 是 Read(讀取)→ Eval(計算)→ Print(印出)→ Loop(重複)的縮寫:你輸入一行,Python 馬上算給你看。

1. 進入

輸入 python(macOS:python3)並按 Enter,出現 >>> 就代表進入了 Python。在 >>> 後面打的東西,是給 Python 的,不是給 Shell 的。

2. 試算

用第 1.1 節的鍵盤案例驗算 A 款毛利率(成本 NT$ 2,800、報價 €100、匯率 31.5):

>>> 1 - 2800 / (100 * 31.5)
0.11111111111111116
>>> f"{1 - 2800 / (100 * 31.5):.1%}"
'11.1%'

第一行結果的尾巴 ...116 是電腦處理小數的正常誤差,用格式化顯示到一位小數即可。再算一筆出口毛利:

>>> revenue = 85000
>>> cost = 52000 + 6500
>>> gross_profit = revenue - cost
>>> gross_profit
26500
>>> f"{gross_profit / revenue:.2%}"
'31.18%'

注意毛利率是除以收入(revenue),不是除以成本(第 1.1 節)。

3. 離開

方法 Windows macOS
輸入指令(兩邊通用) exit() exit()
快速鍵 Ctrl + Z 再按 Enter Ctrl + D

回到 PS C:\...> 或 ... % 的提示字元,就代表回到 Shell 了。


肆、模式二:腳本,一次跑完

REPL 適合試算,關掉就沒了。要重複使用的計算,應該寫成 .py 檔,每次用一行指令執行。

1. 先把規則寫下來

項目 規格
輸入 FOB 貨價、海運運費、保險費率
投保金額 依國際慣例為 CIF 金額的 110%
公式 保險費 = CIF × 110% × 保險費率;CIF = FOB + 運費 + 保險費
難點 保險費要用 CIF 算,CIF 又包含保險費 → 移項得 CIF = (FOB + 運費) ÷ (1 − 1.1 × 保險費率)
輸出 各項金額,千分位、小數兩位

(附錄 G.5 會把同一個公式寫成可重複呼叫的函式。)

2. 程式碼

用任何文字編輯器(VS Code、Antigravity,或 Windows 記事本、macOS 文字編輯)建立 TradeLab/cif_quotation.py:

# cif_quotation.py:把 FOB 報價換算成 CIF 報價(單位:美元)

# ===== 報價參數(改數字只要改這幾行)=====
FOB = 45000.0           # FOB 貨價
FREIGHT = 3800.0        # 海運運費
INSURANCE_RATE = 0.003  # 保險費率 0.3%
INSURED_MARKUP = 1.1    # 依慣例以 CIF 金額的 110% 投保

# 保險費是用 CIF 算的,CIF 又包含保險費,所以要用移項後的公式:
# CIF = (FOB + 運費) ÷ (1 − 1.1 × 保險費率)
cif = (FOB + FREIGHT) / (1 - INSURED_MARKUP * INSURANCE_RATE)
insurance = cif * INSURED_MARKUP * INSURANCE_RATE

print("=" * 36)
print("CIF 報價試算 (USD)")
print("=" * 36)
print(f"FOB 貨價   : {FOB:>12,.2f}")
print(f"海運運費   : {FREIGHT:>12,.2f}")
print(f"保險費     : {insurance:>12,.2f}")
print("-" * 36)
print(f"CIF 報價   : {cif:>12,.2f}")

⚠️ 記事本的陷阱 用 Windows 記事本存檔時,「存檔類型」要選「所有檔案」,否則檔名會變成 cif_quotation.py.txt。存完用 ls 確認檔名。

3. 執行

cd ~\Desktop\TradeLab     # macOS:cd ~/Desktop/TradeLab
ls                        # 確認看得到 cif_quotation.py
python cif_quotation.py   # macOS:python3 cif_quotation.py

輸出:

====================================
CIF 報價試算 (USD)
====================================
FOB 貨價   :    45,000.00
海運運費   :     3,800.00
保險費     :       161.57
------------------------------------
CIF 報價   :    48,961.57

🔍 驗收重點 - 保險費 161.57 ÷ (48,961.57 × 1.1) 是否等於 0.3%?(用 REPL 驗算) - 參數是否都在最上方,而不是埋在公式裡?


伍、跑跑看、壞給你看

實驗 操作 預期結果 想想看
① 在 REPL 裡下 Shell 指令 進入 >>> 後輸入 ls,再輸入 cd .. NameError: name 'ls' is not defined;SyntaxError: invalid syntax 錯誤訊息怎麼告訴你「你在錯的地方」?
② 走錯資料夾 cd ~ 後執行 python cif_quotation.py can't open file ...cif_quotation.py': [Errno 2] No such file or directory 用 E.3 的 pwd 找出問題
③ 改保險費率 把 INSURANCE_RATE 改成 0.005 後重跑 保險費 269.88,CIF 49,069.88 只改一行就重算,這就是「參數放最上方」的好處
④ 簡化公式的誤差 在 REPL 算 (45000 + 3800) * 1.1 * 0.003 161.04,比正確值 161.57 少 0.53 為什麼簡化公式一定會少算?金額放大 100 倍時差多少?

陸、回到情境

小安在 Windows 重新安裝 Python 並勾選 Add to PATH,小凱在 Mac 上改用 python3,兩人都跑出 CIF 48,961.57。但主管接著問:「每批貨的運費都不一樣,難道每次都要打開程式改數字?」

限制 後果 在哪一節解決
貨價、運費寫在程式裡 每換一批貨就要改程式,容易改錯 E.5 命令列參數
結果只顯示在螢幕上 沒有留下紀錄,事後無法查核 E.5 輸出重新導向
之後要用 pandas 等套件 不同專案的套件版本可能互相衝突 E.5 虛擬環境

本節小結

  1. command not found 代表 PATH 清單裡找不到這個程式,不是電腦壞了。
  2. Windows 用 python(或 py),macOS 用 python3。
  3. REPL 適合即時試算,看到 >>> 就要說 Python 的語言;用 exit() 離開。
  4. 腳本適合重複使用:參數放最上方,cd 到檔案所在資料夾再執行。

柒、練習

  1. 改數字(5 分鐘):運費漲到 USD 5,200,修改程式後重跑。CIF 報價變成多少?(答案:50,366.21)
  2. 加功能(20 分鐘):請 AI 在程式中加入「匯率」參數(例如 31.5),多印一行 CIF 的台幣金額(四捨五入到整數)。先寫出規格(輸入、公式、輸出格式),再寫 Prompt,最後用 REPL 驗算 AI 的結果。
  3. 管理反思(討論):實驗 ④ 的簡化公式每筆只差幾毛錢。公司一年出口上千批貨時,這種「看起來很小」的公式錯誤該由誰發現?應該在哪個環節攔下來?(第 5 章會談測試與品質保證。)

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

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

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

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