如何为现有/新建Maven项目添加Maven Wrapper（mvnw）

不管是新建Maven项目还是给已有项目补加Maven Wrapper，操作都很简单，分两种场景说明：

一、新建项目时直接生成Maven Wrapper #

如果你还没创建项目，直接用Maven命令创建带Wrapper的项目：

1. 打开终端，切换到要创建项目的目录
2. 执行以下命令（按需替换groupId、artifactId和Maven版本）：

mvn archetype:generate \
  -DgroupId=com.yourcompany.project \
  -DartifactId=your-project-name \
  -DarchetypeArtifactId=maven-archetype-quickstart \
  -DinteractiveMode=false \
  -Dmaven.version=3.9.6

生成的项目会自动包含mvnw、mvnw.cmd和.mvn目录。

二、给现有Maven项目添加Maven Wrapper #

如果已经有现成的Maven项目，按以下步骤操作：

1. 打开终端，切换到项目的根目录（也就是包含pom.xml的目录）
2. 执行Wrapper生成命令：

mvn wrapper:wrapper

如果需要指定特定版本的Maven（避免不同环境版本不一致），加上版本参数：

mvn wrapper:wrapper -Dmaven=3.9.6

3. 执行完成后，项目根目录会生成三个关键内容：
   • mvnw：Linux/macOS下的可执行脚本
   • mvnw.cmd：Windows下的批处理脚本
   • .mvn目录：包含Wrapper的配置文件和下载逻辑

使用注意事项 #

• 把生成的mvnw、mvnw.cmd和.mvn目录提交到版本控制系统（Git等），这样团队成员无需提前安装Maven，直接用Wrapper脚本执行命令
• Linux/macOS环境下，第一次使用前需要给mvnw添加执行权限：

chmod +x mvnw

• 之后就可以用Wrapper代替原生Maven命令，比如：

# 代替 mvn clean install
./mvnw clean install

Windows环境直接运行：

mvnw.cmd clean install

内容的提问来源于stack exchange，提问作者Ivan