插件必须配置在下才会执行,仅管理模板;maven-compiler-plugin的source/target控制语法和字节码版本,推荐用release;surefire需合规命名和junit 5显式配置;resources默认生效但需显式声明非标准路径和utf-8编码。

plugin 配置写在 <build></build> 还是 <pluginmanagement></pluginmanagement>?
写错位置会导致插件完全不生效,尤其新手常把 maven-compiler-plugin 配在 <pluginmanagement></pluginmanagement> 里却没在 <plugins></plugins> 中显式声明,结果编译还是用默认 JDK 5 语义。
<pluginmanagement></pluginmanagement> 只是“模板管理”,不触发执行;真正要运行的插件必须出现在 <build><plugins></plugins></build> 下。
- 如果是单模块项目,直接配在
<build><plugins></plugins></build>里最稳妥 - 多模块时,父 pom 用
<pluginmanagement></pluginmanagement>统一版本和默认配置,子 pom 在<plugins></plugins>中只写<plugin><groupid></groupid></plugin>+<artifactid></artifactid>即可继承 -
<pluginmanagement></pluginmanagement>里配了<executions></executions>,子 pom 不重写<executions></executions>就不会执行——这点极易被忽略
maven-compiler-plugin 的 source 和 target 到底控制什么?
它们不决定你用什么 JDK 编译,而是告诉插件:“按这个 Java 版本语法和字节码规范来生成 class”。如果设成 11 却用 JDK 8 执行 mvn compile,会直接报错 Unsupported class file major version 55。
-
source控制源码语法(比如能否用var、switch表达式) -
target控制生成的 class 文件兼容目标 JVM(影响能否在低版本 JRE 上运行) - 从 Maven 3.8+ 开始,推荐用
release参数替代二者,例如<release>11</release>,它会自动绑定语言、字节码、API 三者,避免source=11,target=8这种危险组合 - 注意:JDK 17+ 默认启用
--enable-preview相关特性需额外配置,不是靠source/target开关
为什么 maven-surefire-plugin 有时不跑测试,或跑完显示 0 tests?
常见原因是测试类命名不合规,或测试方法签名/修饰符不对,Maven 默认只认 <em>Test.java</em>、Test.java、*Tests.java 这三类文件名。
- 测试方法必须是
public void、无参、非static,且以test开头(JUnit 4)或标注@Test(JUnit 5) - JUnit 5 需显式引入
maven-surefire-plugin2.22.0+,并配置<provider>junit-jupiter</provider>,否则默认只加载 JUnit 4 引擎 - 若测试在
src/test/java之外,得通过<testsourcedirectory></testsourcedirectory>指定路径,否则 Surefire 根本不扫描 - 并行执行时加了
<forkmode></forkmode>或<usesystemclassloader></usesystemclassloader>错误值,也可能导致类加载失败而跳过测试
打包时资源没打进 jar,maven-resources-plugin 需要手动配吗?
不需要。Maven 默认就绑定了 resources:resources 到 process-resources 阶段,但默认只处理 src/main/resources 和 src/test/resources,且过滤关闭。
- 如果资源在其他目录(如
config/),必须用<resources></resources>显式声明,并设<filtering>true</filtering>才能替换${xxx}占位符 - 过滤开启后,XML/properties 文件里的
$符号可能被误解析,建议用\${xxx}转义 -
encoding不设的话,默认用平台编码(Windows 是 GBK),中文乱码多源于此,务必统一设为UTF-8 - 注意:插件本身不决定“打不打进 final jar”,那是
maven-jar-plugin或maven-assembly-plugin的事,resources只负责复制到target/classes
Maven 插件的行为高度依赖阶段绑定、默认约定和隐式继承,改一个配置项常牵出三个副作用。最麻烦的不是不会配,而是配了却不知道它在哪一环失效了。










