如何通过IntelliJ IDEA插件配置「未使用声明」检查规则？

问题背景 #

在IntelliJ IDEA社区版开发JavaEE、Micronaut、Quarkus这类REST应用时，带javax.ws.rs.GET等框架注解的公开方法常会被标记为“未使用”。手动解决是前往Settings > Editor > Inspections > Java > Unused Declaration [Entry points tab]添加忽略注解，但我们要通过插件自动完成这个配置，无需新增检查规则，仅修改现有规则的配置。

两种实现方案 #

1. 用Plugin.xml静态配置（最简单） #

直接借助IntelliJ平台的com.intellij.unusedDeclarationEntryPoints扩展点，在插件的plugin.xml里声明要排除的注解，无需编写Java代码：

<extensions defaultExtensionNs="com.intellij">
    <!-- 注册JAX-RS系列注解 -->
    <unusedDeclarationEntryPoints annotation="javax.ws.rs.GET"/>
    <unusedDeclarationEntryPoints annotation="javax.ws.rs.POST"/>
    <unusedDeclarationEntryPoints annotation="javax.ws.rs.PUT"/>
    <unusedDeclarationEntryPoints annotation="javax.ws.rs.DELETE"/>
    
    <!-- 适配Micronaut注解 -->
    <unusedDeclarationEntryPoints annotation="io.micronaut.http.annotation.Get"/>
    <unusedDeclarationEntryPoints annotation="io.micronaut.http.annotation.Post"/>
    
    <!-- 适配Quarkus/Jakarta EE注解 -->
    <unusedDeclarationEntryPoints annotation="jakarta.ws.rs.GET"/>
    <unusedDeclarationEntryPoints annotation="jakarta.ws.rs.POST"/>
</extensions>

插件加载后，这些注解会自动加入Unused Declaration检查的Entry points列表，社区版就不会再误标带这些注解的方法。

2. 用IntelliJ API动态配置（适合复杂场景） #

如果需要根据项目依赖动态添加注解（比如检测到用户用了Micronaut才加对应注解），可以用InspectionProfileManager操作现有检查规则：

import com.intellij.codeInspection.InspectionProfileManager;
import com.intellij.codeInspection.unusedDeclaration.UnusedDeclarationInspection;
import com.intellij.openapi.project.Project;
import com.intellij.openapi.startup.StartupActivity;

public class RestAnnotationEntryPointSetup implements StartupActivity {
    @Override
    public void runActivity(Project project) {
        UnusedDeclarationInspection inspection = (UnusedDeclarationInspection) 
            InspectionProfileManager.getInstance(project)
                .getCurrentProfile()
                .getTool("UnusedDeclaration", project);
        
        if (inspection == null) return;
        
        // 批量添加REST框架注解
        String[] restAnnotations = {
            "javax.ws.rs.GET", "javax.ws.rs.POST",
            "io.micronaut.http.annotation.Get", "io.micronaut.http.annotation.Post",
            "jakarta.ws.rs.GET", "jakarta.ws.rs.POST"
        };
        
        for (String anno : restAnnotations) {
            inspection.addEntryPointAnnotation(anno);
        }
        
        // 触发配置更新
        InspectionProfileManager.getInstance(project).fireProfileChanged();
    }
}

然后在plugin.xml注册这个启动活动：

<extensions defaultExtensionNs="com.intellij">
    <postStartupActivity implementation="com.your.plugin.package.RestAnnotationEntryPointSetup"/>
</extensions>

验证方法 #

1. 安装插件后，打开Settings > Editor > Inspections > Java > Unused Declaration的Entry points标签页，能看到插件添加的注解已在列表中。
2. 打开带有REST注解的方法，确认不再被标记为“未使用”。

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