A Maven wrapper File .mvn/wrapper/maven-wrapper.properties ... Disable Maven wrapper in settings. : X V

`.mvn/wrapper/maven-wrapper.properties` 是Maven构建工具的一个配置文件，它包含了用于简化Maven项目的自动化设置脚本——Maven Wrapper。这个wrapper允许直接运行`./mvnw`命令而无需全局安装Maven，尤其在CI/CD环境中非常有用。

如果你想要禁用这个Maven Wrapper，可以在你的用户或项目特定的settings.xml文件中做如下设置：

<settings>
  <mirrors>
    <!-- 添加镜像或其他配置，但不包括Maven Wrapper -->
  </mirrors>
  <profiles>
    <profile>
      <id>disable-maven-wrapper</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <properties>
        <mavenWrapperEnabled>false</mavenWrapperEnabled>
      </properties>
    </profile>
  </profiles>
</settings>

通过激活`disable-maven-wrapper` profile，并设置`mavenWrapperEnabled`属性为`false`，就可以关闭Maven Wrapper功能了。

相关问题

mvn wrapper:wrapper

### 如何使用 Maven 创建 Wrapper 文件 `mvnw`

为了创建 Maven Wrapper 文件 `mvnw`，可以按照如下方法操作：

#### 使用命令行工具

在项目根目录下通过命令行执行特定的 Maven 命令来初始化Wrapper。这可以通过运行带有 `-N` 参数以及指定插件目标的命令完成，该参数表示非递归模式，即只影响当前模块而不深入子模块。

对于安装默认版本的 Wrapper 及其关联的 Maven 版本，可以在终端输入以下指令[^5]:

mvn -N io.takari:maven:wrapper

若要指定某个具体的 Maven 版本来生成对应的 Wrapper，则可在原有基础上增加 `-Dmaven=<version>` 的设置方式，例如设定为 3.6.3 版本:

mvn -N io.takari:maven:wrapper -Dmaven=3.6.3

成功执行上述任一命令之后，在项目的根目录将会新增 `.mvn/wrapper/` 文件夹连同其中的内容，还有两个用于不同操作系统环境下的启动脚本——Linux/macOS 下使用的 `mvnw` 和 Windows 平台专用的批处理文件 `mvnw.cmd`[^2]。

需要注意的是，当本地环境中尚未预先配置好 Maven 或者希望避免手动配置时，可以直接利用以上提到的方法在线获取所需资源并自动建立完整的 Maven Wrapper 结构，而无需事先单独下载和全局配置 Maven 工具链[^3]。