Eclipse 設定方法參數類型提示的完整步驟

在 Eclipse 開發 Java 專案時，若滑鼠游標懸停於方法上卻無法顯示參數類型提示，通常是因為專案缺少原始碼或文檔附件。以下是完整的設定流程：

1. 確認已匯入 JAR 並加入建置路徑

在專案上按右鍵 → Build Path → Configure Build Path → Libraries 分頁，確認所需的 JAR 檔已出現在列表中。若缺少，請點選 Add External JARs... 手動加入。

2. 為 JAR 關聯原始碼

1. 在同一視窗中展開該 JAR 節點，選取 Source attachment → Edit...。
2. 選擇 External location，點選 External File... 或 External Folder...，指向對應的 src.zip 或解壓後的原始碼目錄（如 JDK 安裝目錄下的 src.zip、Maven 下載的 -sources.jar）。
3. 確定後，Eclipse 即可在提示中顯示參數名稱與類型。

3. （可選）關聯 Javadoc 文檔

同樣在 JAR 節點下找到 Javadoc location，設定為線上文檔網址（如 https://docs.oracle.com/javase/8/docs/api/）或本地 .html 文檔目錄。設定完成後，懸停提示將顯示完整的方法說明、參數描述與回傳值說明。

常見問題排查

• 提示仍無參數名：確認原始碼附件路徑正確，且版本與 JAR 一致。
• Maven 專案：執行 mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true 或在 Eclipse 中右鍵專案 → Maven → Download Sources / Download Javadoc。
• Gradle 專案：在 build.gradle 加入 eclipse { classpath { downloadSources = true; downloadJavadoc = true } } 並重新匯入。

完成上述設定後，將滑鼠移至方法呼叫處，即可看到完整的參數類型、名稱與文檔提示，大幅提升開發效率。