Maven 基础教程(第二部分)

承接上篇 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. 三大核心配置项

  1. Maven home path:选中本地解压的 maven 根目录(apache-maven-3.9.4)
  2. User settings file:勾选 Override,选中 maven/conf/settings.xml
  3. 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. 创建步骤

  1. File → New → Module,构建工具选择 Maven,语言 Java;
  2. 填写坐标信息:GroupId、ArtifactId、Version;
  3. 选择本地 JDK 版本,点击 Create 自动生成标准 Maven 目录;
  4. 生成目录结构: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 坐标三大核心组成

  1. groupId:组织 / 公司域名反写,如com.itheima
  2. artifactId:当前模块 / 项目名称;
  3. version:版本号,分两种类型
    • SNAPSHOT:快照版本,开发中不稳定,频繁更新;
    • RELEASE:正式发行稳定版,上线使用。

3.3 两种坐标写法

  1. 当前项目自身坐标(写在 pom.xml 根节点)

    com.itheima
    maven-demo
    1.0-SNAPSHOT

  2. 引入第三方依赖坐标(dependencies 内)

    cn.hutool hutool-all 5.8.27

3.4 依赖查询网站

https://mvnrepository.com ,搜索工具包名称直接复制完整坐标。

小节小结

groupId+artifactId+version 三者缺一不可,快照用于开发,正式版用于线上部署。

四、两种导入已有 Maven 项目方式

方式一:Project Structure 导入

  1. File → Project Structure → Modules → Import Module
  2. 选中目标项目里的 pom.xml 文件,确认导入;
  3. 等待 IDEA 加载依赖,刷新 Maven。

方式二:右侧 Maven 面板导入

  1. 打开 IDEA 右侧 Maven 侧边栏;
  2. 点击+号(Add Maven Projects);
  3. 选中外部项目 pom.xml 完成加载。

导入注意事项

  1. 项目存放路径不能包含中文、空格
  2. 导入后若依赖报红,点击 Maven 刷新按钮重新拉取 jar 包。

第二部分全文总结

  1. IDEA 全局 Maven 配置三点:maven 根目录、settings、本地仓库;
  2. 新建 Maven 模块自动生成标准化 main/test 目录;
  3. 坐标三要素:groupId、artifactId、version,区分快照 / 正式版本;
  4. 两种导入已有 Maven 项目方式,均基于 pom.xml 文件加载。

第二部分拓展练习

  1. 打开 IDEA 完成全局 Maven 配置,核对仓库、配置文件路径;
  2. 新建空 Maven 项目,输出一段测试代码运行;
  3. 去 mvnrepository 搜索 commons-io,粘贴坐标引入 pom。