Maven项目管理核心是初始化结构、声明依赖、执行生命周期；用mvn archetype:generate生成标准结构，依赖需正确配置scope和排除冲突，clean compile只编译，package默认运行测试并打包，本地仓库污染需手动清理对应目录。

Java项目用Maven管理，核心就三件事：初始化结构、声明依赖、执行生命周期。没配好 pom.xml 或搞错 mvn 命令阶段，编译失败或类找不到都是常态。

怎么快速生成标准Maven项目结构

别手写目录。用 mvn archetype:generate 最稳，推荐指定官方骨架避免兼容问题：

• mvn archetype:generate -DgroupId=com.example -DartifactId=myapp -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
• 生成后检查 src/main/java 和 src/test/java 是否存在——缺一不可，否则 mvn compile 会跳过源码
• IDE（如IntelliJ）导入时选 “Import project from external model → Maven”，别直接打开文件夹，否则不会识别 target 目录和依赖

依赖声明写错的典型表现和修正点

常见现象是 ClassNotFoundException 或编译报红，但 mvn dependency:tree 显示依赖已下载——大概率是 scope 或版本冲突导致的：

• scope 写成 test 却在 main 里用了 JUnit 的断言类？删掉该 test 行，或改用 compile（默认值，可省略）
• 多个依赖间接引入不同版本的 slf4j-api？运行 mvn dependency:tree -Dverbose 找出冲突路径，再用 排除低版本
• 依赖没生效？确认 在 根节点下，不是嵌套在 或 里

mvn clean compile 和 mvn package 的实际差异

这两个命令看似只是多打包一步，但中间环节差很多，尤其影响调试和部署：

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

• mvn clean compile 只生成 target/classes，不校验测试、不打包、不运行插件（比如未配置 maven-jar-plugin 就不会生成 .jar）
• mvn package 默认触发 test 阶段——如果测试失败，打包直接中断；想跳过测试加 -Dmaven.test.skip=true（注意：这跳过编译和执行，-DskipTests 只跳执行）
• 打出来的 .jar 默认不含依赖，运行会报 NoClassDefFoundError；要可执行包，得配 maven-shade-plugin 或 spring-boot-maven-plugin

本地仓库被污染导致依赖解析失败怎么办

现象是明明 pom.xml 没改，某天突然拉不到 commons-lang3:3.12.0，或者解压后 class 文件是空的——十有八九是本地 ~/.m2/repository 里对应路径下存在不完整或损坏的 .lastUpdated 文件：

• 定位问题依赖：mvn dependency:get -Dartifact=org.apache.commons:commons-lang3:3.12.0 看是否报 Could not find artifact
• 手动删掉对应目录（如 ~/.m2/repository/org/apache/commons/commons-lang3/3.12.0/），再重试 mvn compile
• 更彻底的清理：用 mvn dependency:purge-local-repository，但会清掉所有未被当前项目声明的依赖，慎用

真正麻烦的不是命令记不住，而是 pom.xml 里一个 写死、一个父 POM 版本升级、一个插件配置漏了 ，三者叠加才让 mvn install 在 CI 上莫名失败——这种组合问题，靠查文档不如直接看 mvn -X compile 输出的 debug 日志。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南