函式宣告就像連接程式碼各部分的關節——它們對可讀性和設計有著深遠影響。
一個選擇得當的名稱能讓你無需檢視實作就理解函式用途,並引導你更廣泛地改進。

Change Function Declaration

何時該更改函式宣告?

  • 命名不清:當前名稱無法傳達函式意圖
  • 領域演進:更新參數名稱或順序以更符合領域概念
  • 統一慣例:讓函式名稱和簽章符合專案的風格指南

範例#

重構前#

def add_numbers(x, y):
    return x + y


if __name__ == "__main__":
    result = add_numbers(5, 3)
    print(result)

重構後#

def calculate_sum(x, y):
    return x + y


if __name__ == "__main__":
    result = calculate_sum(5, 3)
    print(result)