IntelliJ IDEA 14 + Maven 創建 Java Web 專案完整圖文教程

手把手教你用 IntelliJ IDEA 14 + Maven 從零搭建標準 Java Web 專案

IntelliJ IDEA 作為公認最強 Java IDE，其 Maven 整合度極高。但初學者常卡在「Web 專案結構配置」、「Artifact 打包」、「Tomcat 整合」三座大山上。本教程以 IDEA 14 + Maven 3 + Tomcat 7 為環境，全流程圖文詳解，助你一次成功跑通「Hello Web」。

環境準備清單

• JDK 1.7+（配置 JAVA_HOME、Path）
• Maven 3.3+（配置 settings.xml 鏡像源、本地倉庫）
• Tomcat 7/8/9（解壓即用，無需安裝）
• IntelliJ IDEA 14+（Ultimate 版支援 Java EE）

第一步：創建 Maven Webapp 骨架專案

1. File → New → Project → Maven，勾選 Create from archetype，選擇 maven-archetype-webapp
2. 填寫坐標：GroupId=com.example、ArtifactId=myweb、Version=1.0-SNAPSHOT
3. 關鍵步驟：在 Properties 對話框添加 archetypeCatalog=internal
   原理：跳過中央倉庫元數據下載，直接使用本地索引，秒級生成骨架
4. 專案名/模組名確認，Finish 等待依賴下載完成

第二步：專案結構標準化（關鍵！）

新建目錄並標記：

• src/main/java → Mark Directory as → Sources Root（藍色資料夾）
• src/main/resources → Resources Root
• src/test/java → Test Sources Root（綠色資料夾）

第三步：Project Structure 核心配置

1. SDK 與 Language Level

• Project SDK：選擇 JDK 1.7/1.8
• Project language level：7/8 - Diamonds, ARM, multi-catch 等

2. Facets：添加 Web 框架支援

• 點擊 + → Web，Deployment Descriptor 指向 webapp/WEB-INF/web.xml
• 若無 web.xml，IDEA 會提示生成，確認即可

3. Artifacts：定義 WAR 打包輸出

• + → Web Application: Exploded → From Modules 選擇當前模組
• Output directory：$PROJECT_DIR$/out/artifacts/myweb_war_exploded
• 關鍵：Output Layout 標籤頁確認 WEB-INF/lib 包含所有 Maven 依賴（compile/runtime scope）

4. Libraries：添加 Tomcat Servlet API（Provided Scope）

• Module → Dependencies → + → JARs or directories 選擇 tomcat/lib/servlet-api.jar
• Scope 設為 Provided（編譯期需要，運行期由容器提供，不打包進 WAR）

5. 添加業務依賴（示例）

• 在 pom.xml <dependencies> 中聲明（如 Spring、MyBatis、Jackson）
• IDEA 右側 Maven 面板點擊 Reimport 自動下載到 External Libraries

第四步：Tomcat 伺服器配置與啟動

1. Run → Edit Configurations → + → Tomcat Server → Local
2. Name：Tomcat 7 MyWeb
3. 
4. Application Server：配置 Tomcat Home（解壓目錄）
5. Deployment 頁籤：+ → Artifact → myweb:war exploded
6. 
7. Application context：/myweb（訪問路徑 https://localhost:8080/myweb）
8. 
9. Server 頁籤修改 HTTP Port（避免 8080 衝突）
10. 
11. OK → 點擊工具欄綠色 Debug 圖標啟動

驗證成果

瀏覽器訪問 https://localhost:8080/myweb 看到 index.jsp 內容，恭喜！標準 Maven Web 專案已就緒。

常見坑點速查表

掌握此流程，未來創建 Spring MVC、Spring Boot Web 專案皆屬同理。建議將配置好的專案另存為「專案模板」，下次直接 File → New → Project from Template 秒級初始化。