Eclipse 專案無法 Convert to Maven Project 解決方案

常見現象

• 右鍵專案無 Configure → Convert to Maven Project 選項。
• 選項存在但進度條卡在 0%，強制關閉 Eclipse 後專案報錯。

核心原因排查

1. 缺少 m2eclipse 插件：Eclipse 未安裝 Maven 集成插件。
   解決：Help → Eclipse Marketplace → 搜索 "Maven" → 安裝 "Maven Integration for Eclipse (m2e)"。
2. 專案性質缺失：.project 文件中無 nature 配置。
   檢查 .project 是否包含：

<natures>
    <nature>org.eclipse.m2e.core.maven2Nature</nature>
    <nature>org.eclipse.jdt.core.javanature</nature>
</natures>

3. pom.xml 位置或內容錯誤：pom.xml 不在專案根目錄，或 XML 格式錯誤。
   確保專案根目錄下有效 pom.xml。
4. 工作空間元數據損壞：.metadata/.plugins/org.eclipse.m2e.core 損壞。
   嘗試：刪除專案 (不勾選 Delete contents) → 重新 Import → Existing Maven Projects。
5. JRE/JDK 配置衝突：專案編譯器版本與 Maven compiler plugin 版本不一致。
   統一配置 maven-compiler-plugin source/target 版本。

標準化轉換流程

1. 確保專案根目錄有合法 pom.xml。
2. 右鍵專案 → Configure → Convert to Maven Project。
3. 若無選項，先 Maven → Enable Dependency Management。
4. 轉換後執行 Maven → Update Project (勾選 Force Update)。
5. 檢查 Java Build Path → Libraries 是否出現 Maven Dependencies。

參考資源

詳細圖文教程：Eclipse Convert to Maven Project 失敗解決

避坑指南

• 使用 File → Import → Existing Maven Projects 直接導入 Maven 專案，避免手動轉換。
• 團隊統一 Eclipse 版本與 m2e 版本，避免元數據不兼容。
• 定期清理 .m2/repository 損壞的依賴包。