E.4 Python 程式在終端機的執行實戰:REPL 對話模式與腳本執行模式
學完本節,你能夠:
- 用 PATH 的概念解釋
command not found類錯誤,並在 Windows 與 macOS 上確認 Python 已可使用。 - 用 REPL 模式做即時試算,並正確離開 REPL。
- 在專案資料夾中執行一支 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。就像總機只會查內線分機表:沒登記的人,就算在公司裡也轉接不到。
有沒有 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 虛擬環境 |
本節小結
command not found代表 PATH 清單裡找不到這個程式,不是電腦壞了。- Windows 用
python(或py),macOS 用python3。 - REPL 適合即時試算,看到
>>>就要說 Python 的語言;用exit()離開。 - 腳本適合重複使用:參數放最上方,
cd到檔案所在資料夾再執行。
柒、練習
- 改數字(5 分鐘):運費漲到 USD 5,200,修改程式後重跑。CIF 報價變成多少?(答案:50,366.21)
- 加功能(20 分鐘):請 AI 在程式中加入「匯率」參數(例如 31.5),多印一行 CIF 的台幣金額(四捨五入到整數)。先寫出規格(輸入、公式、輸出格式),再寫 Prompt,最後用 REPL 驗算 AI 的結果。
- 管理反思(討論):實驗 ④ 的簡化公式每筆只差幾毛錢。公司一年出口上千批貨時,這種「看起來很小」的公式錯誤該由誰發現?應該在哪個環節攔下來?(第 5 章會談測試與品質保證。)