從 SVN 檢出 Maven 專案並在 Eclipse 中正確識別的完整步驟

問題現象

團隊將 Maven 專案提交至 SVN 時，僅提交了 src 與 WebRoot 目錄。其他成員使用 Eclipse SVN 插件檢出後，專案無法被識別為 Maven 專案，缺少依賴管理與建構功能。

解決流程

1. 確認 SVN 倉庫結構：專案根目錄下必須包含 pom.xml，否則無法識別為 Maven 專案。
2. Eclipse 安裝 m2e 插件：確保已安裝 Maven 整合插件（Eclipse 4.5+ 內建）。
3. 檢出專案：
   • 右鍵 Project Explorer → Import → SVN → Projects from SVN。
   • 選擇倉庫 URL，勾選 Checkout as a project in the workspace。
4. 轉換為 Maven 專案：
   • 專案右鍵 → Configure → Convert to Maven Project。
   • Eclipse 會讀取 pom.xml 自動下載依賴並設定建構路徑。
5. 更新 Maven 專案：專案右鍵 → Maven → Update Project，勾選 Force Update of Snapshots/Releases。

常見坑點

• .classpath、.project、.settings 若未提交，需手動轉換；建議團隊統一提交這些 Eclipse 設定檔。
• 若 pom.xml 位於子目錄，檢出時需指定該子目錄為專案根目錄。
• JDK 版本不一致會導致編譯錯誤，請在 Window → Preferences → Java → Installed JREs 統一設定。

參考教學

圖文詳細步驟可見：Eclipse SVN 檢出 Maven 專案完整教程