IntelliJ IDEA 中 Maven 專案創建實戰與資源目錄最佳實踐

IDEA 創建 Maven Web 專案步驟詳解

1. New Project → Maven，勾選 Create from archetype，選擇 maven-archetype-webapp。
2. 填寫坐標：GroupId（通常為包名）、ArtifactId（專案名/打包名）。
3. Maven 配置：指定本地 Maven 路徑、settings.xml、JDK 版本。建議下載 archetype-catalog.xml 至 Maven 目錄加速原型索引。
4. 專案生成後，務必手動創建 src/main/java 目錄並標記為 Sources Root（右鍵 → Mark Directory as → Sources Root），否則 Java 代碼無法編譯。

核心踩坑經驗：非 Java 資源必須放在 resources 目錄

實現 SpringMVC + MyBatis 時，所有非 .java 檔案（如 MyBatis Mapper XML、屬性配置檔等）統統放入 src/main/resources，否則編譯打包時不會進入 classpath，運行時報錯：

class path resource [com/mygroupid/mapper/] cannot be resolved to URL because it does not exist

將 Mapper 檔移至 resources 對應包路徑下即可正常運行。總結：只有 .java 放 src/main/java，其餘資源檔全部放 src/main/resources，才能被 classpath 正確定位。