跳轉至
第 2 章 · 進階基礎

2.8 PEP 8 風格

⏱️ 15 分鐘 📖 互動式 🎯 進階

🎯 學習目標

  • 知道 PEP 8 是什麼
  • 遵守 Python 社群寫作風格
  • 用 formatter(black / ruff)自動排版

📏 PEP 8 速查

規則 範例
縮排 4 空格 def f():\n pass
變數 snake_case user_name = "..."
常數 UPPER_CASE MAX_SIZE = 100
類別 PascalCase class MyClass:
函式 snake_case def calculate():
行長 < 79 字元 太長就換行
函式間空 2 行 模組層
類別內方法空 1 行 類別內
import 放頂部 不要散落
import x 不 import x.y.z 一次一行

🛠️ 自動 formatter

pip install black ruff

# black 自動排版
black myfile.py

# ruff 檢查 + 自動修
ruff check myfile.py --fix

❗ 常見錯誤

  1. 過度遵守:風格是給人看的,不要為規則犧牲可讀性
  2. 混用 tab / 空格:一律用 4 空格

✏️ 練習題

  1. 跑 black 格式化你之前的程式
  2. 用 ruff 檢查錯誤
  3. 把 PEP 8 cheat sheet 收藏起來