Maven Wapper 手册

发表于 更新于 分类于

我们使用 Maven 时，基本上只会用到 mvn 这一个命令。有些童鞋可能听说过 mvnw，这个是啥？

mvnw 是 Maven Wrapper 的缩写，我们安装 Maven 时，默认情况下，系统所有项目都会使用全局安装的这个 Maven 版本。但是，对于某些项目来说，它可能必须使用某个特定的 Maven 版本，这个时候，就可以使用 Maven Wrapper，它可以负责给这个特定的项目安装指定版本的 Maven，而其他项目不受影响。

简单地说，Maven Wrapper 就是给一个项目提供一个独立的，指定版本的 Maven 给它使用。

安装 Maven Wrapper

安装 Maven Wrapper 最简单的方式是在项目的根目录（即 pom.xml 所在的目录）下运行安装命令：

1
mvn -N io.takari:maven:0.7.7:wrapper

它会自动使用最新版本的 Maven。注意 0.7.7 是 Maven Wrapper 的版本。最新的 Maven Wrapper 版本可以去官方网站查看。

如果要指定使用的 Maven 版本，使用下面的安装命令指定版本，例如 3.6.0：

1
mvn -N io.takari:maven:0.7.7:wrapper -Dmaven=3.6.0

安装后，查看项目结构：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Hello-World
├── .mvn
│   └── wrapper
│       ├── MavenWrapperDownloader.java
│       ├── maven-wrapper.jar
│       └── maven-wrapper.properties
├── mvnw
├── mvnw.cmd
├── pom.xml
└── src
    ├── main
    │   ├── java
    │   └── resources
    └── test
        ├── java
        └── resources

发现多了 mvnw、mvnw.cmd 和 .mvn目录。

使用 Maven Wapper

我们只需要把 mvn 命令改成 mvnw 就可以使用跟项目关联的 Maven。例如：

1
mvnw clean package

Maven Wrapper 的另一个作用是把项目的 mvnw、mvnw.cmd 和 .mvn 提交到版本库中，可以使所有开发人员使用统一的 Maven 版本。