Maven Wrapper 使用指南

张开发
2026/4/18 19:49:41 15 分钟阅读

分享文章

Maven Wrapper 使用指南
Maven Wrapper 使用指南Maven Wrapper (mvnw) 是一个让项目自包含 Maven 构建工具的机制,确保所有开发者使用相同的 Maven 版本。什么是 Maven Wrapper?Maven Wrapper 是由mvnw(Unix/Linux/macOS)或mvnw.cmd(Windows)脚本组成的项目自包含脚本,它包含:Maven 分发脚本- 自动下载并运行指定版本的 Maven配置文件-.mvn/wrapper/maven-wrapper.properties定义 Maven 版本和源项目独立性- 开发者无需安装 Maven 即可构建项目为什么使用 Maven Wrapper?问题不使用 Maven Wrapper使用 Maven Wrapper版本不一致不同开发者有不同 Maven 版本所有开发者自动使用相同版本环境配置需要手动安装 Maven自动下载,无需手动配置CI/CD 兼容性服务器 Maven 版本可能不同统一构建环境新成员入门需要先安装配置 Maven克隆项目即可构建项目中当前配置本项目的 Maven Wrapper 配置:Maven 版本: 3.9.11 下载源: https://repo.maven.apache.org/maven2 配置文件: .mvn/wrapper/maven-wrapper.properties使用方法基本用法使用./mvnw替代mvn命令:# 编译项目./mvnw clean compile# 运行应用./mvnw spring-boot:run# 运行测试./mvnwtest# 打包./mvnw clean package首次使用首次运行./mvnw时,它会:检查本地 Maven 缓存(~/.m2/wrapper/)如果不存在,从配置的源下载 Maven使用下载的 Maven 执行构建示例输出:[INFO] Downloaded from https://repo.maven.apache.org/maven2/.../maven-3.9.11-bin.zip [INFO] Unpacked maven...Maven Wrapper 与环境变量重要:Maven Wrapper 仍受环境变量影响Maven Wrapper 虽然自包含 Maven,但它运行的 Java 版本仍由系统环境决定:# 即使使用 ./mvnw,如果 Java 环境错误,仍会失败./mvnw clean compile# 错误:Maven 用 Java 21 运行,但项目需要 Java 8正确的使用流程步骤 1:设置正确的 Java 环境# 设置 JAVA_HOMEexportJAVA_HOME

更多文章