.mvn目录&mvnw和mvnw.cmd文件说明

短命女 2022-11-07 13:13 38阅读 0赞

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

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

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

### 安装Maven Wrapper ###

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

mvn -N io.takari:maven:0.7.6:wrapper

它会自动使用最新版本的Maven。注意`0.7.6`是Maven Wrapper的版本。最新的Maven Wrapper版本可以去[官方网站][Link 1]查看。

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

mvn -N io.takari:maven:0.7.6:wrapper -Dmaven=3.3.3

安装后，查看项目结构：

my-project
    ├── .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`目录，我们只需要把`mvn`命令改成`mvnw`就可以使用跟项目关联的Maven。例如：

mvnw clean package

在Linux或macOS下运行时需要加上`./`：

./mvnw clean package

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

> 这使您可以运行Maven项目，而**无需安装Maven**并将其显示在路径上。如果找不到正确的Maven版本（就我所知，默认情况下在你的用户主目录中），它会下载它。
> 
> **该`mvnw`文件适用于Linux（bash），`mvnw.cmd`适用于Windows环境。**
> 
> 要创建或更新所有必需的Maven Wrapper文件，请执行以下命令：
> 
>     mvn -N io.takari:maven:wrapper
> 
> 要使用不同版本的maven，可以按如下方式指定版本：
> 
>     mvn -N io.takari:maven:wrapper -Dmaven=3.3.3
> 
> `PATH`如果你的项目中已经有了mvnw，你可以使用这两个命令，`./mvnw`而不是`mvn`在命令中。
> 
> Command `mvnw`使用默认情况下`~/.m2/wrapper`在第一次使用时下载的Maven 。
> 
> Maven的URL在每个项目中指定`.mvn/wrapper/maven-wrapper.properties`：
> 
>     distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.3.9/apache-maven-3.3.9-bin.zip
> 
> 要更新或更改Maven版本，请调用以下内容（记住关于`--non-recursive`多模块项目）：
> 
>     ./mvnw io.takari:maven:wrapper -Dmaven=3.3.9
> 
> 或者只是`.mvn/wrapper/maven-wrapper.properties`手动修改。
> 
> 使用Maven从头开始生成包装器（您需要在`PATH`运行时使用它：
> 
>     mvn io.takari:maven:wrapper -Dmaven=3.3.9

### 练习 ###

从下载练习：[使用mvnw编译hello项目][mvnw_hello] （推荐使用[IDE练习插件][IDE]快速下载）

### 小结 ###

使用Maven Wrapper，可以为一个项目指定特定的Maven版本。

[Link 1]: https://github.com/takari/maven-wrapper
[mvnw_hello]: https://gitee.com/liaoxuefeng/learn-java/blob/master/practices/Java%E6%95%99%E7%A8%8B/140.Maven%E5%9F%BA%E7%A1%80.1255945359327200/60.%E4%BD%BF%E7%94%A8mvnw.1305148057976866/maven-wrapper.zip?utm_source=blog_lxf
[IDE]: https://www.liaoxuefeng.com/wiki/1252599548343744/1266092093733664