Eclipse User Library 管理依賴 JAR 包：從創建到部署發布全流程

為什麼要用 User Library？

默認所有 JAR 扔進 Web App Libraries 會導致依賴混亂、難以按模塊管理。User Library 允許按功能/層級分組管理 JAR（如：Spring、MyBatis、Logging、Utils），構建路徑清晰，團隊協作統一。

第一步：創建 User Library 並添加 JAR

1. 右鍵項目 → Build Path → Configure Build Path
2. 選 Libraries 標籤 → Add Library → User Library → Next
3. 點 User Libraries → New → 輸入名稱（如 Spring-4.2.5） → OK
4. 選中新建庫 → Add External JARs → 選擇對應 JAR 文件 → Open
5. 依次點擊 Finish → Apply and Close

第二步：關鍵——部署裝配 發布到 WEB-INF/lib

User Library 不會自動隨項目發布到服務器，直接啟動會報 ClassNotFoundException。必須配置 Deployment Assembly：

1. 右鍵項目 → Properties → Deployment Assembly
2. 點 Add → Java Build Path Entries → Next
3. 勾選剛創建的 User Library（如 Spring-4.2.5） → Finish
4. Apply and Close

第三步：驗證發布效果

1. 啟動 Tomcat，項目正常加載無 ClassNotFound 錯誤。
2. 查看服務器部署目錄 wtpwebapps/項目名/WEB-INF/lib，確認 JAR 已複製到位。

最佳實踐建議

• 按技術棧分庫：Spring-Core、MyBatis、Jackson、Apache-Commons、Database-Driver 等。
• 團隊統一 Library 定義，導出 .prefs 或共享工作區配置，保證構建一致性。
• 漸進式遷移：Maven 項目優先用 Maven 管理依賴；非 Maven 老項目用 User Library 分層治理。
• 定期清理無用 JAR，避免 Library 膨脹。

總結

User Library 解決「構建時依賴管理」，Deployment Assembly 解決「運行時依賴發布」。兩步配置，讓 Eclipse 非 Maven 項目依賴管理井井有條。