Integer.getInteger 陷阱：當方法重載變成「諧音重載」的命名災難

Java 5 中發現 Integer.getInteger(String)：根據系統屬性名獲取整數值。而非開發者直覺的「將字串解析為整數」（那是 Integer.valueOf(String) 的職責）。

災難現場

本質診斷：Near-Phrase Overloading（諧音重載）

作者創造術語「諧音重載」：極相似的命名（valueOf vs getInteger、gm vs cm）表達完全不同的語義。呼叫端極易在同一上下文誤用，導致隱蔽 Bug。正確命名應為 getIntegerProperty 以揭示「讀取系統屬性」的真實意圖。

教訓

1. API 設計應避免「諧音重載」，語義差異必須在命名中顯式體現。
2. 開發者須建立「查閱 Javadoc 再用陌生靜態方法」的肌肉記憶。
3. 代碼審查時重點檢查 Integer.getInteger/Boolean.getBoolean/Long.getLong 等系統屬性讀取族方法的誤用。

這是 Java 標準庫中最令人困惑的命名陷阱之一——他們本可以做得更漂亮。