【Maven】项目管理工具

news2025/4/25 11:49:54

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`

命名规范建议

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

项目结构规范

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自动生成）