一、创建Maven项目
1、配置Maven环境(全局)




2、创建项目


3、配置jdk版本


4、创建Maven项目
1.创建模块



2.创建test下面的resources


完整的Maven目录:

3.创建类


二、Maven坐标
什么是坐标?简单来说,Maven 中的坐标就是资源的唯一标识,通过它我们可以精准定位到任何一个 jar 包。坐标不仅用于定义项目本身,也用于引入项目中需要的依赖。
Maven 坐标主要由三部分组成:
- groupId:定义当前 Maven 项目隶属的组织名称,通常是域名反写,比如
org.example。 - artifactId:定义当前 Maven 项目名称,也就是模块名称,例如
order-service、goods-service。 - version:定义当前项目版本号。这里要注意
SNAPSHOT和RELEASE的区别:SNAPSHOT表示功能不稳定、正在开发中的快照版本;RELEASE则表示功能稳定、可以用于发行的版本。如果不带RELEASE标识,具体版本号默认也是RELEASE。
三、导入Maven项目
导入已有项目有两种常见方式:
- 方式一:通过
File → Project Structure → Modules → Import Module,然后选择 Maven 项目的pom.xml文件。 - 方式二:在 Maven 面板中点击
+(Add Maven Projects),同样选择项目的pom.xml。
实际操作中的小建议:最好先将要导入的 Maven 项目复制到你的项目目录下,再选择 pom.xml 进行导入,这样路径更清晰,不容易出错。
四、依赖配置
依赖就是当前项目运行所需要的 jar 包,一个项目可以引入多个依赖。配置起来也很直观:
- 在
pom.xml中编写标签。 - 在
内部使用引入坐标。 - 定义好坐标的
groupId、artifactId、version。 - 点击刷新按钮(或按
Ctrl+Shift+O),让 IDEA 拉取最新加入的依赖。
通常我们去 https://mvnrepository.com/ 查找需要的依赖。比如搜索 spring-context:


把找到的坐标复制粘贴到 pom.xml 中,然后点击右上角的刷新按钮进行下载:

下载完成后,左侧 External Libraries 里会看到新增的 jar 包:

注意,这里它会自动下载很多间接依赖,这种现象就叫依赖传递。
五、排除依赖
有时候我们不希望引入某个传递过来的依赖,就需要主动排除它。排除依赖时,被排除的资源不需要指定版本,直接指定 groupId 和 artifactId 即可。
使用 标签,例如:
org.springframework spring-context 6.1.4 io.micrometer micrometer-observation

需要留意两点:
- 一旦依赖配置变了,记得重新加载项目(刷新 Maven 面板)。
- 如果引入的依赖在本地仓库不存在,必须保证联网,否则下载会失败。
六、Maven生命周期
Maven 的生命周期是为了统一所有 Maven 项目的构建过程。它定义了从清理、编译到部署的完整流程。Maven 中有三套相互独立的生命周期:
- clean:清理工作。
- default:核心工作,包括编译、测试、打包、安装、部署等。
- site:生成报告、发布站点。
生命周期阶段
以下是最常用的几个阶段:
- clean:移除上一次构建生成的文件。
- compile:编译项目源代码。
- test:使用合适的单元测试框架(如 JUnit)运行测试。
- package:将编译后的文件打包,如 jar、war 等。
- install:安装项目到本地仓库。

关键点:在同一套生命周期中,执行后面的阶段时,前面的阶段会自动执行。比如你执行 install,它会先执行 compile、test、package 等。
执行指定生命周期有两种方式:
- 在 IDEA 右侧的 Maven 工具栏中,双击对应的生命周期。
- 在命令行中通过命令执行,例如
mvn clean install。
总结
以上是 IDEA 集成 Maven 的完整流程,从环境配置、项目创建、坐标理解、依赖管理到生命周期,每一步都配有截图。希望这份指南能为正在搭建 Java 开发环境的读者提供一份清晰的参考。