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

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)