🏗️ 第一章：Maven是高级乐高玩家

🔍 依赖管理的基本单元

<!-- 每个依赖就是一个乐高零件 -->
<dependency><groupId>com.lego</groupId>    <!-- 零件系列 --><artifactId>engine</artifactId> <!-- 具体零件 --><version>2.0</version>         <!-- 零件版本 --><scope>runtime</scope>         <!-- 使用场景 -->
</dependency>

乐高 vs Maven 类比表：

乐高术语	Maven对应概念	作用
零件包	Dependency	功能模块
拼装说明书	POM.xml	构建指南
零件分类箱	Local Repository	本地仓库
乐高官网	Maven Central	中央仓库
定制零件商店	Nexus/Artifactory	私服

💡 小剧场：

当你在pom里加依赖时，Maven就像个乐高管家：

"主人要的’发动机2.0’，我从中央仓库（乐高官网）给您下载~

如果缺零件，我还会去您配置的私服（定制商店）找找！"

🧩 第二章：多模块项目——乐高巨舰组装术

🌟 为什么要拆分模块？

• 问题场景：单模块项目变成"一锅乱炖"

monolith-project/
├── src/
│   ├── main/
│   │   ├── java/  # 所有代码混在一起
│   │   └── resources/
└── pom.xml        # 依赖列表长达200行！

• 解决方案：按功能拆分成"乐高模块"

modular-project/
├── api/           # 接口定义
├── core/          # 核心逻辑
├── web/           # 控制器
└── pom.xml        # 父POM管理公共配置

🛠️ 父子POM配置示范

父pom.xml（相当于乐高底板）：

<modules>
<module>api</module>
<module>core</module>
<module>web</module>
</modules><!-- 统一管理依赖版本 -->
<dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>2.7.0</version><type>pom</type><scope>import</scope></dependency></dependencies>
</dependencyManagement>

子模块pom.xml（特定零件包）：

<!-- 继承父POM -->
<parent><groupId>com.mycompany</groupId><artifactId>parent</artifactId><version>1.0</version>
</parent><!-- 声明自己的依赖 -->
<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><!-- 无需写版本，父POM已管理 --></dependency>
</dependencies>

拆分技巧：

• 按职责划分：比如order-service, user-service
• 按架构分层：比如model, repository, service
• 黄金法则：一个模块的变更不应频繁影响其他模块

⚔️ 第三章：依赖冲突——乐高零件不兼容事件

🔥 经典冲突场景

[WARNING] Found conflict:
com.google.guava:guava:jar:
20.0 (compile) vs 30.0-jre (compile)

🛡️ 三大解决武器

武器1：依赖排除（精准拆除）

<dependency><groupId>org.apache.hadoop</groupId><artifactId>hadoop-common</artifactId><exclusions><exclusion>  <!-- 排除冲突零件 --><groupId>com.google.guava</groupId><artifactId>guava</artifactId></exclusion></exclusions>
</dependency>

武器2：依赖锁定（版本固化）

<!-- 在dependencyManagement中锁定版本 -->
<dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>31.1-jre</version>
</dependency>

武器3：mvn命令分析（侦探工具）

# 查看依赖树
mvn dependency:tree# 分析冲突
mvn dependency:analyze-duplicate# 终极武器：图形化展示
mvn dependency:tree -DoutputFile=deps.txt

💡 冲突解决黄金法则：

“就近优先” → Maven会选择依赖树中离项目更近的版本

🏭 第四章：私服搭建——企业级乐高仓库

🤔 为什么需要私服？

• 加速构建（缓存常用依赖）
• 托管内部二方库
• 安全隔离（避免直连外网）

🚧 Nexus私服踩坑记录

坑1：默认admin密码在哪？

# 安装后第一次启动时生成
nexus-install-dir/sonatype-work/nexus3/admin.password

坑2：上传jar返回400错误

# 必须指定repository参数
curl -u admin:password --upload-file my.jar \
http://nexus:8081/repository/maven-releases/com/example/my/1.0/my-1.0.jar

坑3：代理中央仓库慢

# 修改nexus/etc/nexus-default.properties
nexus.remote.storage.connection.timeout=60000
nexus.remote.storage.connection.max.total=200

🌟 最佳实践配置

<!-- settings.xml 配置私服镜像 -->
<mirror><id>nexus</id><url>http://nexus:8081/repository/maven-public/</url><mirrorOf>*</mirrorOf>
</mirror>

🧰 第五章：Maven高级工具包

🛠️ 常用插件推荐

插件	作用	示例命令
versions	依赖版本升级	mvn versions:use-latest-versions
dependency	分析依赖	mvn dependency:analyze
spotbugs	静态代码分析	mvn spotbugs:check
jacoco	测试覆盖率	mvn jacoco:report

💡 冷知识：依赖范围(scope)详解

<!-- 像选择乐高使用场景 -->
<dependency><scope>compile</scope>   <!-- 默认值，全程参与 --><scope>provided</scope>  <!-- 容器会提供，如Servlet API --><scope>runtime</scope>   <!-- 仅运行时需要，如JDBC驱动 --><scope>test</scope>      <!-- 只在测试用，如JUnit -->
</dependency>

🌟 终极心法

"好的Maven项目应该像乐高大师的作品：

• 模块化：每个零件各司其职
• 低耦合：更换零件不影响整体
• 可追溯：版本明确不混乱"

👉 行动清单：

• 用mvn dependency:tree检查你的项目依赖树
• 尝试将一个单体项目拆分成多模块
• 搭建本地Nexus私服体验企业级管理

记住：依赖管理不是玄学，而是精确的积木拼装艺术。现在就去优化你的"乐高作品"吧！ 🧱✨