如何编写无需指定executions的Maven插件？

一、让clr Goal自动绑定到CLEAN阶段（无需重复配置Execution） #

你之前用@Execute注解用错了——这个注解是用来在执行当前Mojo时触发另一个Goal的，不是用来绑定生命周期阶段的。正确的自动绑定方式要结合@Mojo的defaultPhase属性和插件描述符的正确生成：

1. 先把ClearMojo的注解配置正确，确保defaultPhase设为CLEAN：

@Mojo(name = "clr", defaultPhase = LifecyclePhase.CLEAN, requiresProject = true)
public class ClearMojo extends AbstractLatexMojo {
    // 你的业务逻辑代码
}

添加requiresProject = true是为了确保该Mojo仅在项目环境中生效，符合CLEAN阶段的使用场景。

2. 插件项目的pom.xml必须配置maven-plugin-plugin，它会根据Mojo类上的注解生成正确的插件描述符（plugin.xml），Maven才能识别这个生命周期绑定：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-plugin-plugin</artifactId>
            <version>3.11.0</version>
            <executions>
                <execution>
                    <id>default-descriptor</id>
                    <goals>
                        <goal>descriptor</goal>
                    </goals>
                    <phase>process-classes</phase>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

3. 用户使用你的插件时，只需在pom.xml中引入插件即可，完全不需要配置executions节点：

<build>
    <plugins>
        <plugin>
            <groupId>你的插件groupId</groupId>
            <artifactId>latex-maven-plugin</artifactId>
            <version>你的插件版本</version>
        </plugin>
    </plugins>
</build>

现在执行mvn clean时，clr Goal会自动执行，无需额外配置。如果之前用户手动添加过execution配置，记得删除以避免重复执行。

二、优化vrs Goal的差异化执行逻辑 #

针对vrs的两种场景（直接执行mvn latex:vrs输出详细版本列表、随mvn deploy执行仅警告版本超限），不用让用户在pom.xml里配置参数，直接在Mojo代码中自动判断执行上下文即可：

实现思路 #

通过MavenSession对象获取当前执行的目标和阶段，判断是直接调用latex:vrs，还是在deploy阶段中执行，自动设置versionsWarnOnly的取值。

代码示例 #

@Mojo(name = "vrs", defaultPhase = LifecyclePhase.VALIDATE)
public class VersionCheckMojo extends AbstractLatexMojo {

    @Parameter(defaultValue = "false")
    private boolean versionsWarnOnly;

    @Component
    private MavenSession session;

    @Override
    public void execute() throws MojoExecutionException, MojoFailureException {
        // 判断当前是直接调用vrs，还是在deploy阶段执行
        boolean isDirectCall = session.getGoals().stream()
                .anyMatch(goal -> goal.equals("latex:vrs"));
        boolean isDeployPhase = session.getCurrentProject().getExecutionProject()
                .getLifecyclePhases().contains(LifecyclePhase.DEPLOY.getId());

        // 自动设置参数值
        if (isDeployPhase) {
            this.versionsWarnOnly = true;
        } else if (isDirectCall) {
            this.versionsWarnOnly = false;
        }
        // 其他场景保留用户可能配置的默认值

        // 版本检查核心逻辑
        if (versionsWarnOnly) {
            // 版本超范围时仅输出警告
            getLog().warn("工具版本超出预设范围！");
        } else {
            // 输出所有工具的详细版本信息
            getLog().info("lualatex版本：xxx");
            getLog().info("makeindex版本：xxx");
            getLog().info("mpost版本：xxx");
        }
    }
}

额外说明 #

• 如果用户需要手动覆盖自动逻辑，仍可以在pom.xml中配置versionsWarnOnly参数，代码仅在特定场景下自动赋值，不会覆盖用户的显式配置。
• 也支持通过系统属性临时控制，比如执行mvn latex:vrs -DversionsWarnOnly=true强制开启警告模式，灵活性更高。

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