在 Java Web 开发中，Maven 是必不可少的项目管理与构建工具，它能帮我们自动管理依赖、打包项目、统一项目结构，彻底告别手动导入 jar 包的烦恼。而 IntelliJ IDEA 作为主流的 Java 开发工具，已经完美集成了 Maven，无需额外配置环境，就能快速搭建标准的 Web 项目。

本篇博客将从零开始，手把手教你在 IDEA 中使用 Maven 创建 Java Web 项目，补全项目结构、配置依赖、部署 Tomcat 运行

开始创建项目前，确保你的电脑已完成以下配置：

1. JDK 8+：Java 开发环境（推荐 JDK8/JDK11，企业最常用），并配置好系统环境变量；
2. IntelliJ IDEA：2020 及以上版本均可（社区版 / 旗舰版通用，本教程使用 2024.2 版本）；
3. Tomcat：Web 服务器（推荐 Tomcat8.5/Tomcat9，用于运行项目）；
4. IDEA 内置 Maven：无需单独下载安装，直接使用即可（追求稳定可配置本地 Maven）。

步骤 1：新建 Maven 项目

打开 IDEA，进入欢迎界面，点击 New Project（新建项目）。

步骤 2：选择 Maven 骨架

1. 左侧菜单栏选择 Maven；
2. 勾选 Create from archetype（从骨架创建项目）；
3. 在下方列表中找到并选择org.apache.maven.archetypes:maven-archetype-webapp
4. 点击 Next。

配置项目基本信息

填写项目唯一标识（Maven 坐标）：

• GroupId：公司 / 个人域名反写（个人项目可写 com.自己名字，如 com.liangchao）；
• ArtifactId：项目名称（自定义，如 maven-web-demo）；
• Version：项目版本（默认 1.0-SNAPSHOT 即可）；

填写完成后点击 Next。

配置 Maven 环境（关键！解决下载慢问题）

这一步是新手最容易踩坑的地方，默认 Maven 中央仓库在国外，下载依赖极慢，推荐配置阿里云镜像：

1. Maven home path：选择 Bundled (Maven 3.x.x)（使用 IDEA 内置 Maven）；
2. User settings file：勾选 Override，选择你本地的 settings.xml；
3. 如果你没有配置过 Maven，直接用 IDEA 默认即可，后续我会教你手动加镜像；
4. 点击 Next → Finish，完成项目创建。

等待 Maven 初始化项目

IDEA 会自动下载 maven-archetype-webapp 骨架的依赖文件，右下角会显示加载进度。✅ 出现 BUILD SUCCESS 提示，说明项目初始化成功！

三、补全 Java Web 标准目录结构

Maven 的 webapp 骨架只会生成 web 相关目录，缺少 Java 源代码目录和配置文件目录，我们需要手动补全（核心步骤）：

1. 创建缺失目录

找到项目结构：

src
  └─ main
      ├─ webapp  (Web 根目录，已生成)
      ├─ java    (缺失：存放 Java 源代码)
      └─ resources (缺失：存放配置文件)

• 右键 main 文件夹 → New → Directory；
• 依次创建 java 和 resources 两个文件夹。

标记目录类型（让 IDEA 识别）

1. 右键 java 文件夹 → Mark Directory as → Sources Root（源码根目录，变蓝色）；
2. 右键 resources 文件夹 → Mark Directory as → Resources Root（配置文件根目录，变灰色）。

✅ 至此，项目的标准目录结构就补全完成了！

四、核心配置：pom.xml 依赖管理

pom.xml 是 Maven 项目的核心配置文件，我们需要添加 Servlet 依赖（Web 项目必备）。

1. 添加 Servlet API 依赖

打开项目根目录下的 pom.xml，在 <dependencies> 标签中添加以下代码：

<!-- Servlet 依赖 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <!-- 作用域：provided 表示仅编译时使用，打包时不包含，避免与 Tomcat 冲突 -->
    <scope>provided</scope>
</dependency>

刷新 Maven 依赖

添加完成后，IDEA 会自动弹出 刷新提示，点击 Refresh（或右键项目 → Maven → Reload Project），Maven 会自动下载依赖。

配置 Tomcat 服务器并运行项目

项目搭建完成后，我们需要配置 Tomcat 来运行 Web 项目：

步骤 1：添加 Tomcat 服务

1. 点击 IDEA 右上角 Add Configuration...；
2. 点击左上角 + → 找到 Tomcat Server → Local；
3. 在 Server 选项卡中，点击 Configure...，选择你本地的 Tomcat 安装目录；
4. 点击 Apply 保存。

步骤 2：部署项目

1. 切换到 Deployment 选项卡；
2. 点击右下角 + → Artifact...；
3. 选择项目的 war 包：xxx:war exploded（热部署模式，推荐）；
4. Application context：设置项目访问路径（默认 /项目名，可改为 /，直接用域名访问）；
5. 点击 OK。

步骤 3：启动项目并测试

1. 点击右上角 绿色启动按钮，启动 Tomcat；
2. 启动成功后，浏览器会自动打开：http://localhost:8080；
3. 页面显示 Hello World!，说明项目运行成功！

总结

本篇教程我们完成了：

1. 使用 IDEA + Maven 骨架快速创建 Web 项目；
2. 补全 Java Web 标准目录结构；
3. 配置核心 Servlet 依赖；
4. 集成 Tomcat 并成功运行项目。

Maven 大大简化了 Java Web 项目的搭建和依赖管理，是后端开发的必备技能。后续我们可以在这个项目基础上，开发 Servlet、JSP、SSM、SpringBoot 等 Web 项目，快速进阶 Java 后端开发！

如果本篇教程对你有帮助，欢迎点赞收藏，有问题可以在评论区留言～