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 的断言类？删掉该<scope>test</scope>行，或改用compile（默认值，可省略） - 多个依赖间接引入不同版本的
slf4j-api？运行mvn dependency:tree -Dverbose找出冲突路径，再用<exclusions></exclusions>排除低版本 - 依赖没生效？确认
<dependencies></dependencies>在<project></project>根节点下，不是嵌套在<build></build>或<profiles></profiles>里
mvn clean compile 和 mvn package 的实际差异
这两个命令看似只是多打包一步，但中间环节差很多，尤其影响调试和部署：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
-
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 里一个 <version></version> 写死、一个父 POM 版本升级、一个插件配置漏了 <executions></executions>，三者叠加才让 mvn install 在 CI 上莫名失败——这种组合问题，靠查文档不如直接看 mvn -X compile 输出的 debug 日志。
