maven versions plugin 是一套用于管理项目版本、依赖版本和父版本的工具集合。它可以帮助你高效地更新项目版本号、检查依赖更新、回滚变更等,尤其适合在持续集成和版本发布流程中使用。
一、基础版本管理
# 设置项目的新版本(会产生 pom.xml.versionsbackup 备份文件) mvn versions:set -dnewversion=2026.03.28 # 确认版本修改,移除所有备份文件 mvn versions:commit # 回滚到版本修改之前的状态(恢复备份文件) mvn versions:revert
二、父项目和属性版本管理
# 更新父项目版本(根据仓库中的最新版本或指定版本) mvn versions:update-parent # 更新 pom.xml 中 <properties> 里定义的版本号 mvn versions:update-properties
三、依赖与插件更新检查
# 显示哪些依赖有可用的新版本 mvn versions:display-dependency-updates # 显示哪些插件有可用的新版本 mvn versions:display-plugin-updates # 显示哪些依赖的版本存在更新(更详细的输出) mvn versions:display-dependency-updates -dverbose=true # 显示哪些插件存在更新 mvn versions:display-plugin-updates
四、批量更新依赖版本
# 将所有依赖替换为最新的 release 版本 mvn versions:use-latest-releases # 将所有依赖替换为最新的 snapshot 版本 mvn versions:use-latest-snapshots # 将所有依赖替换为指定版本范围的最新版本 mvn versions:use-latest-versions
五、高级用法与常见场景
1. 跳过某些模块的版本更新
mvn versions:set -dnewversion=1.0.0 -dgeneratebackuppoms=false -pl '!module-to-skip'
2. 指定更新规则(如只更新特定 groupid)
mvn versions:use-latest-releases -dincludes=com.example:*
3. 批量更新插件版本
mvn versions:update-properties -dincludes=spring-framework.version
六、注意事项
- 执行 versions:set 后,建议先通过 git diff 检查变更,再决定是否执行 commit。
- 默认会生成 .versionsbackup 备份文件,建议在提交前清理。
- 在 ci 环境中,建议结合 -b(批处理模式)使用,避免交互式输入。
七、总结
maven versions plugin 是管理多模块项目、依赖版本统一升级和版本发布流程中的重要工具。合理使用它可以显著提升项目维护效率,降低人为错误风险。建议在项目开发周期中定期使用 display-dependency-updates 等命令,及时了解依赖和插件的更新情况,保持项目依赖的健康与安全。
到此这篇关于maven versions plugin 使用小结的文章就介绍到这了,更多相关maven versions plugin 使用内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论