IntelliJ IDEA 實戰（一）：從零創建 Maven Web 項目並配置源碼目錄

前言：告別 Eclipse 卡頓，擁抱 IDEA 流暢體驗

Maven Web 專案在 Eclipse 中常面臨「莫名錯誤標記、清理項目還要清 Tomcat、依賴解析失敗」等痛點。IntelliJ IDEA 憑藉智能索引、原生 Maven 整合、強大的項目結構識別，成為 Java 開發首選。本文手把手演示：創建專案、配置 Maven、標記源碼/測試/資源目錄、設置輸出路徑，奠定後續容器配置基礎。

環境準備

• IDEA 2016.1+（本文基於 2016.1，新版本 UI 微調但流程一致）
• JDK 1.7/1.8 已配置 JAVA_HOME
• Maven 3.3+ 已安裝並配置 settings.xml（鏡像倉庫、本地倉庫路徑）

步驟 1：創建 Maven 專案

1. File → New → Project
2. 左側選 Maven，勾選 Create from archetype → 選 maven-archetype-webapp（或不勾選稍後手動建目錄）
3. 
4. 填寫坐標：GroupId、ArtifactId、Version
5. 

步驟 2：配置 Maven 環境（關鍵）

1. 下一頁指定 Maven home directory（而非使用內建）
2. 勾選 User settings file → 指向你的 settings.xml
3. 勾選 Local repository → 指向本地倉庫路徑
4. 
5. 點擊 Finish，IDEA 開始下載依賴、建立索引

步驟 3：完善標準 Maven 目錄結構

archetype 生成的結構可能缺失 src/main/java、src/test/java 等目錄，需手動補全：

project-root
├── src
│   ├── main
│   │   ├── java          ← 標記為 Sources Root (藍色)
│   │   ├── resources     ← 標記為 Resources Root
│   │   └── webapp        ← Web 資源目錄 (WEB-INF/web.xml)
│   └── test
│       ├── java          ← 標記為 Test Sources Root (綠色)
│       └── resources     ← 標記為 Test Resources Root
├── target                ← 編譯輸出（自動生成）
└── pom.xml

標記目錄（核心操作）

1. Ctrl+Alt+Shift+S 打開 Project Structure
2. Modules → Sources 頁籤
3. 右鍵目錄 → Mark as 選擇對應類型：
   • src/main/java → Sources (藍色)
   • src/main/resources → Resources
   • src/test/java → Tests (綠色)
   • src/test/resources → Test Resources
4. 

步驟 4：設置編譯輸出路徑

1. 在 Project Structure → Modules → Paths
2. Compiler output 選 Use module compile output path
3. 路徑設置為：target/classes（Maven 標準）
4. Test output path：target/test-classes
5. 

驗證：運行一個簡單 Main 類，查看 target/classes 下生成 .class 文件。

步驟 5：配置 web.xml 與 Maven 依賴

• 確保 src/main/webapp/WEB-INF/web.xml 存在（Servlet 3.0+ 可選）
• pom.xml 添加 Web 依賴：

  <dependencies>
      <!-- Servlet API (provided 由容器提供) -->
      <dependency>
          <groupId>javax.servlet</groupId>
          <artifactId>javax.servlet-api</artifactId>
          <version>3.1.0</version>
          <scope>provided</scope>
      </dependency>
      <!-- JSP/JSTL (若使用 JSP) -->
      <dependency>
          <groupId>javax.servlet.jsp</groupId>
          <artifactId>javax.servlet.jsp-api</artifactId>
          <version>2.3.1</version>
          <scope>provided</scope>
      </dependency>
      <dependency>
          <groupId>jstl</groupId>
          <artifactId>jstl</artifactId>
          <version>1.2</version>
      </dependency>
  </dependencies>

• 點擊 IDEA 右側 Maven 面板 Reimport 刷新依賴

常見問題排查

總結

「創建專案 → 配置 Maven → 標記目錄 → 設置輸出 → 導入依賴」五步走，建立標準化 Maven Web 專案骨架。目錄標記是 IDEA 識別代碼/資源/測試的關鍵，輸出路徑對齊 Maven 標準可避免部署找不到類。下一篇將接續配置 Tomcat/Jetty 實現熱部署調試。