承接上篇 Maven 概述、安装配置,本篇讲解 IDEA 全局 Maven 环境配置、新建 Maven 项目、Maven 坐标、已有项目导入,属于整套教程中段内容,下篇将讲解依赖管理、生命周期、JUnit 单元测试、常见报错。
一、IDEA 全局 Maven 环境配置
开发前需要在 IDEA 统一配置本地 Maven,后续所有新项目自动复用这套配置,无需重复设置。
1. 打开配置入口
File → Settings(Windows) / IntelliJ IDEA → Settings(Mac)路径:Build, Execution, Deployment → Build Tools → Maven
2. 三大核心配置项
- Maven home path:选中本地解压的 maven 根目录(apache-maven-3.9.4)
- User settings file:勾选 Override,选中 maven/conf/settings.xml
- Local repository:自动读取 settings 中配置的本地仓库路径,可手动覆盖修改
3. 配套编译器设置
进入 Settings → Build, Execution, Deployment → Compiler → Java Compiler统一项目字节码版本,和本地 JDK 版本保持一致(如 JDK17 对应 17)。
4. Runner 附加配置
Maven 下 Runner 面板可配置运行 JDK、环境变量;勾选Delegate IDE build/run actions to Maven,让编译运行完全交由 Maven 插件执行。
小节小结
全局 Maven 配置一次生效所有新项目,核心三件套:maven 根目录、settings 配置文件、本地仓库。
二、新建 Maven 项目(模块)
2. 创建步骤
- File → New → Module,构建工具选择 Maven,语言 Java;
- 填写坐标信息:GroupId、ArtifactId、Version;
- 选择本地 JDK 版本,点击 Create 自动生成标准 Maven 目录;
- 生成目录结构:pom.xml、src/main、src/test。
标准项目结构自动生成
项目根
└── pom.xml
├── src
├── main/java 业务代码
├── main/resources 配置文件
└── test/java 单元测试代码
简单 HelloWorld 测试
在 main/java 下新建类,编写 main 方法运行,验证项目构建环境正常。
三、Maven 坐标详解
3.1 坐标作用
坐标是项目 / 第三方 jar 包在仓库里的唯一身份证,通过坐标精准定位资源。
3.2 坐标三大核心组成
- groupId:组织 / 公司域名反写,如
com.itheima; - artifactId:当前模块 / 项目名称;
- version:版本号,分两种类型
- SNAPSHOT:快照版本,开发中不稳定,频繁更新;
- RELEASE:正式发行稳定版,上线使用。
3.3 两种坐标写法
-
当前项目自身坐标(写在 pom.xml 根节点)
com.itheima
maven-demo
1.0-SNAPSHOT -
引入第三方依赖坐标(dependencies 内)
cn.hutool hutool-all 5.8.27
3.4 依赖查询网站
https://mvnrepository.com ,搜索工具包名称直接复制完整坐标。
小节小结
groupId+artifactId+version 三者缺一不可,快照用于开发,正式版用于线上部署。
四、两种导入已有 Maven 项目方式
方式一:Project Structure 导入
- File → Project Structure → Modules → Import Module
- 选中目标项目里的 pom.xml 文件,确认导入;
- 等待 IDEA 加载依赖,刷新 Maven。
方式二:右侧 Maven 面板导入
- 打开 IDEA 右侧 Maven 侧边栏;
- 点击
+号(Add Maven Projects); - 选中外部项目 pom.xml 完成加载。
导入注意事项
- 项目存放路径不能包含中文、空格;
- 导入后若依赖报红,点击 Maven 刷新按钮重新拉取 jar 包。
第二部分全文总结
- IDEA 全局 Maven 配置三点:maven 根目录、settings、本地仓库;
- 新建 Maven 模块自动生成标准化 main/test 目录;
- 坐标三要素:groupId、artifactId、version,区分快照 / 正式版本;
- 两种导入已有 Maven 项目方式,均基于 pom.xml 文件加载。
第二部分拓展练习
- 打开 IDEA 完成全局 Maven 配置,核对仓库、配置文件路径;
- 新建空 Maven 项目,输出一段测试代码运行;
- 去 mvnrepository 搜索 commons-io,粘贴坐标引入 pom。