0

0

Maven pom.xml build plugins 插件配置详解

幻夢星雲

幻夢星雲

发布时间:2026-02-20 08:40:03

|

103人浏览过

|

来源于php中文网

原创

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

maven pom.xml build plugins 插件配置详解

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-pluginsourcetarget 到底控制什么?

它们不决定你用什么 JDK 编译,而是告诉插件:“按这个 Java 版本语法和字节码规范来生成 class”。如果设成 11 却用 JDK 8 执行 mvn compile,会直接报错 Unsupported class file major version 55

NexChatGPT
NexChatGPT

火爆全网的IDEA插件,支持IDEA全家桶

下载
  • source 控制源码语法(比如能否用 varswitch 表达式)
  • 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-plugin 2.22.0+,并配置 <provider>junit-jupiter</provider>,否则默认只加载 JUnit 4 引擎
  • 若测试在 src/test/java 之外,得通过 <testsourcedirectory></testsourcedirectory> 指定路径,否则 Surefire 根本不扫描
  • 并行执行时加了 <forkmode></forkmode><usesystemclassloader></usesystemclassloader> 错误值,也可能导致类加载失败而跳过测试

打包时资源没打进 jar,maven-resources-plugin 需要手动配吗?

不需要。Maven 默认就绑定了 resources:resourcesprocess-resources 阶段,但默认只处理 src/main/resourcessrc/test/resources,且过滤关闭。

  • 如果资源在其他目录(如 config/),必须用 <resources></resources> 显式声明,并设 <filtering>true</filtering> 才能替换 ${xxx} 占位符
  • 过滤开启后,XML/properties 文件里的 $ 符号可能被误解析,建议用 \${xxx} 转义
  • encoding 不设的话,默认用平台编码(Windows 是 GBK),中文乱码多源于此,务必统一设为 UTF-8
  • 注意:插件本身不决定“打不打进 final jar”,那是 maven-jar-pluginmaven-assembly-plugin 的事,resources 只负责复制到 target/classes

Maven 插件的行为高度依赖阶段绑定、默认约定和隐式继承,改一个配置项常牵出三个副作用。最麻烦的不是不会配,而是配了却不知道它在哪一环失效了。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

450

2023.10.13

java测试工具有哪些
java测试工具有哪些

java测试工具有JUnit、TestNG、Mockito、Selenium、Apache JMeter和Cucumber。php还给大家带来了java有关的教程,欢迎大家前来学习阅读,希望对大家能有所帮助。

310

2023.10.23

Java 单元测试
Java 单元测试

本专题聚焦 Java 在软件测试与持续集成流程中的实战应用,系统讲解 JUnit 单元测试框架、Mock 数据、集成测试、代码覆盖率分析、Maven 测试配置、CI/CD 流水线搭建(Jenkins、GitHub Actions)等关键内容。通过实战案例(如企业级项目自动化测试、持续交付流程搭建),帮助学习者掌握 Java 项目质量保障与自动化交付的完整体系。

22

2025.10.24

switch语句用法
switch语句用法

switch语句用法:1、Switch语句只能用于整数类型,枚举类型和String类型,不能用于浮点数类型和布尔类型;2、每个case语句后面必须跟着一个break语句,以防止执行其他case的代码块,没有break语句,将会继续执行下一个case的代码块;3、可以在一个case语句中匹配多个值,使用逗号分隔;4、Switch语句中的default代码块是可选的等等。

559

2023.09.21

Java switch的用法
Java switch的用法

Java中的switch语句用于根据不同的条件执行不同的代码块。想了解更多switch的相关内容,可以阅读本专题下面的文章。

435

2024.03.13

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1929

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2104

2024.08.01

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

660

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号