JDK API 文檔閱讀指南：方法簽名與說明的對應關係

螢幕截圖中的兩個箭頭

• 左側箭頭：指向方法的回傳值型別（如 String、int、void、List<E> 等）。
• 右側箭頭：指向該方法的文字說明，包含功能描述、參數含義、回傳值語意、拋出異常、執行緒安全性等。

完整方法簽名結構

修飾符  回傳型別  方法名稱(參數列表)  拋出異常
public    String    toString()               // 回傳物件字串表示
static    int       parseInt(String s) throws NumberFormatException

高效閱讀技巧

1. 先看類別概述與類別繼承樹，建立心智模型。
2. 關注方法摘要表：修飾符、回傳型別、方法名、參數——快速掃描找目標方法。
3. 點進方法詳細說明：重點閱讀「參數說明」「回傳值說明」「拋出異常」「範例代碼」。
4. 善用「Use」頁面：查看該類別/方法被哪些其他類別使用，理解實際場景。

常見誤區

• 以為左側是「參數型別」——其實參數在方法名稱後的括號內。
• 忽略 throws 子句，導致未捕獲受檢異常。
• 只看方法名不看回傳型別，誤以為 void 方法有回傳值。

熟練閱讀 JDK 文檔是 Java 開發者的核心基本功，建議養成「先查文檔再寫代碼」習慣。