IntelliJ IDEA 導入 Maven 項目全流程圖解：從安裝到 Tomcat 部署運行

環境準備

• JDK 1.8+（配置 JAVA_HOME、PATH）
• Maven 3.3.9+（解壓，配置 MAVEN_HOME、PATH）
• Tomcat 9（解壓，無需安裝）
• IntelliJ IDEA 2017+（Community/Ultimate 均可）

步驟 1：配置 IDEA 全局 Maven 設置

1. 打開 File → Settings → Build, Execution, Deployment → Maven
2. Maven home directory：指向本地 Maven 解壓目錄（如 D:\apache-maven-3.3.9）
3. User settings file：指向 conf/settings.xml（可自定義鏡像倉庫、Profile）
4. Local repository：建議修改至非 C 盤（如 D:\maven-repo），避免系統盤爆滿
5. 點擊 Apply → OK

步驟 2：導入 Maven 項目

1. 右側邊欄點擊 Maven Projects 面板
2. 點擊工具欄 +（Add Maven Project）
3. 選擇項目根目錄下的 pom.xml → OK
4. IDEA 解析 pom，Maven Projects 面板顯示模塊結構

步驟 3：依賴下載與編譯

1. Maven Projects 面板點擊 Lifecycle → clean
2. 再點擊 install（或 compile + package）
3. 觀察下方控制台下載依賴至本地倉庫

步驟 4：配置 Tomcat 服務器

1. 頂部工具欄 Run/Debug Configurations 下拉框 → Edit Configurations...
2. 點擊 + → 選擇 Tomcat Server → Local
3. Server 頁簽：Application Server 選擇 Tomcat 解壓目錄
4. Deployment 頁簽：點擊 + → Artifact... → 選擇項目生成的 war exploded 或 war
5. 應用上下文路徑可改為 / 或項目名

步驟 5：啟動驗證

1. 點擊工具欄綠色 ▶ Run 或 Shift+F10
2. 控制台輸出 Tomcat 啟動日誌，無紅字報錯
3. 瀏覽器訪問 https://localhost:8080/項目名 或 /，頁面正常渲染

常見坑點速查表

遵循「全局 Maven → 導入項目 → 下載依賴 → 配置 Tomcat → 運行」五步法，IDEA 開發 Maven 項目將行雲流水。