IntelliJ IDEA 创建 Maven 项目完整指南

前言

在 Java 开发的世界里，项目构建工具就像一位得力的管家——它帮你管理依赖、编译代码、打包部署，让你专注于业务逻辑本身。而在众多构建工具中，Maven 凭借其标准化的项目结构和强大的依赖管理能力，成为了 Java 生态中最广泛使用的构建工具之一。

无论你是刚入门 Java 的新手，还是准备搭建新项目的老手，在 IntelliJ IDEA 中创建一个 Maven 项目都是一项必备技能。本文将带你从零开始，手把手完成整个过程。

‍

简介

Maven 是 Apache 软件基金会下的一个开源项目管理工具，核心理念是  "约定优于配置"（Convention Over Configuration） 。它通过一个名为pom.xml（Project Object Model）的文件来描述项目的结构、依赖和构建方式。

使用 Maven 的核心优势：

• •标准化项目结构：所有 Maven 项目遵循统一的目录规范，降低团队协作成本

• •自动化依赖管理：通过声明坐标即可自动下载和管理第三方 JAR 包

• •丰富的生命周期：内置编译、测试、打包、部署等完整的构建流程

• •庞大的生态仓库：Maven Central 拥有数百万个开源组件，几乎覆盖所有常见需求

IntelliJ IDEA 作为 JetBrains 出品的 Java IDE，对 Maven 提供了开箱即用的深度集成，从项目创建到依赖管理，再到构建运行，全程可视化操作，极大降低了上手门槛。

‍

操作步骤

一、环境准备

在开始之前，请确保你的开发环境满足以下条件：

| 环境要求 | 说明 | | :-- | :-- | | JDK | JDK 8 或以上版本（推荐 JDK 17 / 21） | | IntelliJ IDEA | Community Edition（免费）或 Ultimate Edition 均可（这里演示使用2021版本） | | Maven | IDEA 内置了 Maven，也可使用本地安装的版本 | | 网络 | 首次创建项目需要联网下载依赖 |

相关安装可参考之前文章

提前确认 JDK 已正确安装并配置了环境变量 JAVA_HOME，终端执行 java -version 可验证。

‍

二、创建 Maven 项目

第 1 步：打开新建项目向导

启动 IntelliJ IDEA，在欢迎页面点击  「New Project」 （新建项目）。

如果你已经打开了一个项目，可以通过菜单栏File → New → Project 进入。

‍

第 2 步：选择项目类型

在左侧的项目类型列表中，选择  「Maven Archetype」 （Maven 原型）。

选择 Archetype（原型）

Archetype 是 Maven 的项目模板机制，常用的有：

| Archetype | 说明 | 适用场景 | | :-- | :-- | :-- | | maven-archetype-quickstart | 简单的 Java 项目 | 基础 Java 学习、工具类开发 | | maven-archetype-webapp | Web 应用项目 | Servlet / JSP 项目 | | maven-archetype-archetype | 创建自定义原型 | 高级定制 |

初学者建议选择**maven-archetype-quickstart**，它会生成一个包含基础目录结构和示例代码的项目。

‍

‍

第 3 步：配置项目名称、项目坐标（GAV）

Maven 通过GAV 坐标 来唯一标识一个项目，这是 Maven 世界中的"身份证"：

GroupId    :  com.example           （组织/公司域名反写）
ArtifactId :  my-maven-app          （项目唯一标识）
Version    :  1.0-SNAPSHOT          （版本号，SNAPSHOT 表示开发中版本）

填写说明：

| 字段 | 填写规则 | 示例 | | :-- | :-- | :-- | | GroupId | 通常为公司域名的反写，全部小写 | com.example 、org.mycompany | | ArtifactId | 项目名称，使用短横线分隔 | my-maven-app 、user-service | | Version | 默认即可，后续可修改 | 1.0-SNAPSHOT |

‍

‍

第 5 步：配置 Maven 参数

在展开的高级设置中，确认以下参数：

Maven home path     :  使用 IDEA 自带的 Bundled（Maven 3）或指定本地路径
User settings file  :  Maven 的 settings.xml 路径（可自定义镜像仓库地址）
Local repository    :  本地仓库路径（默认在用户目录下的 .m2/repository）

‍

加速提示：如果下载依赖较慢，建议在 settings.xml 中配置国内镜像源（如阿里云）：

<mirrors>
<mirror>
 <id>aliyun</id>
 <mirrorOf>central</mirrorOf>
 <name>Aliyun Mirror</name>
 <url>https://maven.aliyun.com/repository/central</url>
</mirror>
</mirrors>

第 6 步：完成创建

点击  「Create」  按钮，IDEA 将自动：

等待右下角进度条完成，项目创建成功。

‍

‍

三、项目结构说明

创建完成后的目录结构如下：

my-maven-app/
├── pom.xml                          ← 项目核心配置文件
├── src/
│   ├── main/
│   │   ├── java/                    ← 主代码目录
│   │   │   └── com/example/
│   │   │       └── App.java         ← 生成的示例主类
│   │   └── resources/               ← 资源文件目录（配置文件等，需手动创建）
│   └── test/
│       ├── java/                    ← 测试代码目录
│       │   └── com/example/
│       │       └── AppTest.java     ← 生成的示例测试类
│       └── resources/               ← 测试资源目录
└── target/                          ← 编译输出目录（配置文件等，需手动创建）

这就是 Maven 约定的标准目录结构，所有 Maven 项目都遵循这个规范。

‍

新增resource目录

‍

‍

‍

四、认识 pom.xml

pom.xml 是 Maven 项目的灵魂，打开后你会看到：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>my-maven-app</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

关键标签说明：

| 标签 | 作用 | | :-- | :-- | | <dependencies> | 声明项目所需的第三方依赖 | | <properties> | 定义变量，统一管理版本号等 | | <packaging> | 打包方式：jar（默认）、war、pom | | <scope> | 依赖作用域：compile（默认）、test、provided、runtime |

添加新依赖只需在<dependencies> 中增加一组<dependency> 坐标，保存后 IDEA 会自动下载。例如添加 MySQL 驱动：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
</dependency>

‍

五、常用 Maven 操作

在 IDEA 中，你可以通过右侧 Maven 工具面板 执行常用命令：

| 操作 | 说明 | | :-- | :-- | | clean | 清理 target 目录 | | compile | 编译源代码 | | test | 运行测试 | | package | 打包项目（生成 jar/war） | | install | 打包并安装到本地仓库 |

‍

你也可以在 IDEA 底部的Terminal 中直接执行 Maven 命令：

mvn clean compile        # 清理并编译
mvn clean package        # 清理并打包
mvn clean install        # 清理并安装到本地仓库
mvn dependency:tree      # 查看依赖树

---

六、运行项目

控制台输出：

Hello World!

项目运行成功，至此完整的 Maven 项目已搭建完毕。

‍

‍

第八步：编写第一个程序

java复制

package com.example;

public class HelloMaven {
    public static void main(String[] args) {
        System.out.println("Hello, Maven! 技海拾贝");
    }
}

1. 3. 右键点击文件 →Run 'HelloMaven.main()' ，控制台输出即表示成功！

‍

‍

常见问题排坑

| 问题 | 解决方案 | | :-- | :-- | | 依赖下载失败 / 超时 | 配置阿里云镜像源，或检查网络代理设置 | | IDEA 不识别 Maven 项目 | 右键pom.xml →Add as Maven Project | | JDK 版本不匹配 | 检查pom.xml 中maven.compiler.source/target 是否与项目 JDK 一致 | | 编码乱码 | 在pom.xml 的<properties> 中添加<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> | | Maven 工具面板消失 | 菜单View → Tool Windows → Maven 重新打开 |

‍

‍

结束语

至此，你已经掌握了在 IntelliJ IDEA 中创建 Maven 项目的完整流程——从环境准备、项目创建、目录结构理解，到pom.xml 配置和常用操作，每一步都为后续的 Java 开发打下了坚实的基础。

Maven 的世界远不止于此：多模块项目管理、自定义插件开发、私服搭建（Nexus）……随着你项目经验的增长，这些进阶技能会逐渐成为你的得力武器。

‍

如果这篇文章对你有帮助，欢迎关注微信公众号「技海拾贝」，持续获取 Java 开发、架构设计、工程实践等优质技术内容。

‍