Eclipse 編譯警告「請使用 -Xlint:unchecked 重新編譯」完整解決方案

警告根因

使用 JDK 5+ 泛型時，對原始類型（如 Map、List）進行未檢查操作（如 new HashMap()、map.put(key, value)），編譯器發出 unchecked 警告，提示潛在類型安全風險。

五種解決方案對比

實戰驗證結果

• 方案 1（-source 1.5 實為啟用泛型）✅ 編譯通過，報表正常
• 方案 2 ❌ 當時 javac 不支持該註解
• 方案 3 ✅ 代碼改為 Map，編譯通過且類型安全
• 方案 4 ❌ 經驗證無效（可能配置位置錯誤）
• 方案 5 ✅ 添加 <compilerarg value="-Xlint:unchecked"/> 後編譯通過，僅輸出警告不報錯

最佳實踐建議

1. 新代碼：強制使用完整泛型聲明（方案 3），配合 IDE 自動提示完成
2. 存量代碼：分模塊漸進式重構，關鍵路徑優先
3. 構建流程：CI 階段啟用 -Xlint:unchecked -Werror 將警告升級為錯誤，防止新增未檢查代碼
4. 第三方交互：在適配層使用 @SuppressWarnings 隔離，不污染核心代碼