1. 项目概述与准备工作
作为一名长期使用IntelliJ IDEA进行Java Web开发的工程师,我经常需要从零开始搭建Maven Web项目。虽然这个过程看似基础,但其中包含不少容易踩坑的细节。今天我就来详细分享在IDEA中使用Maven创建Web项目的完整流程,包括那些官方文档不会告诉你的实用技巧。
在开始之前,请确保你已经准备好以下环境:
- IntelliJ IDEA Ultimate版(社区版也能用但功能有限)
- JDK 1.8或以上版本(推荐JDK 11 LTS)
- Maven 3.6.3+
- Tomcat 9.x(或其他Servlet容器)
提示:虽然IDEA内置了Maven,但我强烈建议使用本地安装的Maven,这样可以统一团队开发环境,避免因IDE版本不同导致的构建差异。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 创建Maven Web项目
2.1 项目初始化
打开IDEA后,按照以下步骤创建项目:
- 点击菜单栏 File → New → Project
- 在左侧选择"Maven Archetype"
- 勾选"Create from archetype"选项
- 在列表中找到并选择"maven-archetype-webapp"
- 点击Next进入下一步
这里有个关键点:为什么选择webapp archetype而不是普通的Maven项目?因为这个模板已经预置了Web项目的基本目录结构(如WEB-INF/web.xml),可以省去手动创建的麻烦。
2.2 配置项目坐标
在项目坐标配置页面,需要填写以下关键信息:
- GroupId: 通常使用公司域名倒写,如com.example
- ArtifactId: 项目名称,建议使用小写字母和连字符,如xmall
- Version: 初始版本号,默认为1.0-SNAPSHOT
注意:ArtifactId不要使用特殊字符或空格,否则可能导致构建问题。我曾经因为使用下划线导致部署失败,花了半天时间排查。
2.3 项目结构修正
创建完成后,你会发现项目结构并不完整,缺少以下关键目录:
- src/main/java(存放Java源代码)
- src/test/java(存放测试代码)
手动创建这些目录的正确方式:
- 右键点击src/main
