【Maven】项目管理工具

Maven：一个项目管理工具

前言

传统项目管理存在的问题：

• 依赖管理混乱
  • 需要自己去网上搜 jar 包，找对版本很痛苦（还容易找错）
  • 某个库依赖另一个库（传递依赖），你得自己挨个找齐
  • 不小心引入多个版本的 jar，运行时会出错（版本冲突）
• 重复劳动严重
  • 每个新项目都要手动去复制一堆 jar 包
  • jar 包变更后，每台电脑都得手动同步
  • 拷来拷去，很容易拷错或漏拷
• 项目臃肿
  • 所有依赖都塞进项目 lib/ 目录，体积越来越大
  • 压缩打包项目时，把几十个 jar 全打进去，严重拖慢部署速度
• 缺乏标准的构建流程
• 编译、测试、打包步骤全靠人工或写 shell 脚本
• 没有统一规范，团队成员各干各的，出问题互相甩锅
• 测试和生产环境构建出来的包可能不一致
• 依赖冲突难排查
  • 不小心引入了多个版本的 jar 包，运行时才发现问题
  • 没有依赖树工具，不知道是哪个库带来的冲突
• 团队协作成本高
  • 新人加入团队，要手动搭建环境、找依赖
  • 打包部署靠经验和习惯，出错风险高
  • 无法快速复现线上环境（缺乏统一配置）

Maven的出现 解决了这一切的问题
Maven 提供了：

功能	核心价值
pom.xml 统一配置	告别手动管理依赖，实现"配置即文档"
本地/中央仓库机制	自动下载依赖，解决传统方式手动拷贝jar包的问题
生命周期 + 插件系统	自动化构建、测试、打包，统一团队构建流程
依赖树分析	通过mvn dependency:tree快速定位冲突，解决jar包版本兼容问题
多模块支持	父子POM结构轻松拆分大型项目，实现模块化开发
profile 配置	一套POM支持多环境（dev/test/prod），避免维护多个配置文件

---

Maven 是什么

简介

• Maven的本质是一个项目管理工具，将项目开发和管理过程抽象成一个项目对象模型（POM）
• POM（Project Object Model）：项目对象模型

作用

• 项目构建：提供标准的、跨平台的自动化项目构建方式
• 依赖管理：方便快捷的管理项目依赖的资源(jar包)，避免资源间的版本冲突问题
• 统一开发结构：提供标准的、统一的项目结构

---

POM 是什么

简介

pom 即 pom.xml，是 Maven 项目的核心配置文件，是项目的“说明书”。

作用

• 描述项目基本信息（名称、版本等）
• 声明依赖（告诉 Maven 需要哪些库）
• 定义构建规则（插件、打包方式等）
• 配置构建生命周期（编译→测试→打包）
• 标识是父项目或子模块

最小可运行配置

<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"><!-- 1. 固定的 POM 模型版本，目前只有这个版本，不可修改 --><modelVersion>4.0.0</modelVersion><!-- 2. 唯一标识这个项目的“坐标” --><groupId>com.example</groupId><artifactId>demo</artifactId><version>1.0.0</version></project>

常用标签解析

---

仓库

• 用于存储资源，包含各种iar包
• 仓库分类:
  • 本地仓库:自己电脑上存储资源的仓库，连接远程仓库获取资源
  • 远程仓库:非本机电脑上的仓库，为本地仓库提供资源
    • 中央仓库:Maven团队维护，存储所有资源的仓库
    • 私服:部门/公司范围内存储资源的仓库，从中央仓库获取资源
• 私服的作用:
  • 保存具有版权的资源，包含购买或自主研发的iar
    • 中央仓库中的iar都是开源的，不能存储具有版权的资源
  • 一定范围内共享资源，仅对内部开放，不对外共享

---

坐标

简介及作用

• groupId + artifactId + 版本号统称为坐标，用于在 Maven 仓库中唯一定位项目，可以唯一定位到某个 jar 包
• 类似地图坐标的概念，通过组合值精确定位资源

---

artifactId

• 项目/模块标识名
• 示例：
  tomcat | spring-core | myproject-api

---

groupId

• 组织标识名（采用反向域名规则）
• 分段说明：
  • 第一段：域分类
    com（商业组织）| org（非营利组织）| cn（国家代码）
  • 第二段起：组织名称
    如：fullstack | apache | google

---

组合示例

项目示例	groupId	artifactId	version
Apache Tomcat	org.apache	tomcat	3.0.1
商业公司项目	com.fullstack	payment-system	3.0.1

命名规范建议

1. groupId 采用小写字母+点分结构
2. artifactId 使用小写字母+连字符（kebab-case）
3. 确保组合在仓库中全局唯一

项目结构规范

your-project/
├── pom.xml                        # Maven 主配置文件
├── README.md                      # 项目说明文档
├── .gitignore                     # Git 忽略文件配置
├── src/
│   ├── main/
│   │   ├── java/                  # 主代码目录
│   │   │   └── com/
│   │   │       └── yourcompany/
│   │   │           └── yourproject/
│   │   │               ├── Application.java         # 启动类
│   │   │               ├── controller/              # 控制器
│   │   │               ├── service/                 # 服务层
│   │   │               ├── repository/              # DAO/Repository 层
│   │   │               ├── model/                   # 实体类或DTO/VO类
│   │   │               ├── config/                  # 配置类，如拦截器、跨域、安全、Swagger等
│   │   │               └── utils/                   # 工具类
│   │   └── resources/             # 配置与资源文件
│   │       ├── application.yml    # Spring Boot 配置
│   │       ├── application-dev.yml
│   │       ├── application-prod.yml
│   │       ├── static/            # 静态资源（前端静态文件：html/js/css/images）
│   │       ├── templates/         # 模板文件（Thymeleaf、Freemarker等）
│   │       └── mapper/            # MyBatis XML 文件
│   ├── test/
│   │   ├── java/                  # 测试代码
│   │   │   └── com/
│   │   │       └── yourcompany/
│   │   │           └── yourproject/
│   │   │               └── ApplicationTests.java
│   │   └── resources/            # 测试资源
├── target/                        # 编译输出目录（Maven自动生成）