前言
在 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（Maven3）或指定本地路径 User settingsfile: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 项目的灵魂，打开后你会看到：
<?xmlversion="1.0"encoding="UTF-8"?><projectxmlns="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 cleaninstall# 清理并安装到本地仓库mvn dependency:tree# 查看依赖树六、运行项目
控制台输出：
Hello World!项目运行成功，至此完整的 Maven 项目已搭建完毕。
第八步：编写第一个程序
java复制
package com.example;public class HelloMaven{public static void main(String[]args){System.out.println("Hello, Maven! 技海拾贝");}}- 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 开发、架构设计、工程实践等优质技术内容。
