自定义Gradle插件未显示在IntelliJ IDEA工具栏，如何解决？

问题描述 #

我按照Gradle官方文档编写了一个简单的自定义Gradle插件，代码如下：

class MyBuild implements Plugin<Project> {
    @Override
    void apply(Project project) {
        project.task("test") {
            doLast{
                println 'Yeaaa boy!'
            }
        }
    }
}
apply plugin: MyBuild

但该插件并未出现在IntelliJ IDEA的Gradle工具栏中（截图如下）：

我还尝试添加了以下代码，但没有任何效果：

idea {
    project {
        jdkName = '1.8'
        languageLevel = '1.8'
    }
    apply plugin: MyBuild
}

解决方案 #

首先明确：IntelliJ IDEA的Gradle工具栏默认不会直接显示插件本身，而是展示插件提供的任务、扩展或分组。以下是针对性解决步骤：

1. 给插件任务指定分组（让任务显示在工具栏） #

未分组的任务默认会被归到other分组，可能不易找到。给任务指定自定义分组和描述，就能在工具栏的对应分组下清晰看到：

class MyBuild implements Plugin<Project> {
    @Override
    void apply(Project project) {
        project.task("test") {
            group = "自定义插件任务" // 设置任务所属分组
            description = "执行自定义插件测试逻辑" // 添加任务描述
            doLast{
                println 'Yeaaa boy!'
            }
        }
    }
}
apply plugin: MyBuild

同步Gradle后，即可在工具栏的自定义插件任务分组下找到test任务。

2. 刷新IDEA的Gradle同步 #

有时候IDEA未及时更新Gradle配置，执行以下操作之一即可：

• 点击Gradle工具栏的刷新按钮（🔄图标）
• 选择菜单栏File → Sync Project with Gradle Files

3. 修正插件应用位置 #

你之前在idea块内应用插件的做法是错误的，idea块仅用于配置IDEA项目相关设置，插件应直接在脚本根级别应用。

4. 检查Gradle视图显示设置 #

确保工具栏没有隐藏任务：

• 点击Gradle工具栏右上角的齿轮图标（⚙️）
• 确认Show Tasks下的选项均已勾选，尤其是Other或你自定义的分组

若需让插件本身出现在Plugins列表 #

如果你的需求是让插件显示在工具栏的Plugins列表中，需要将插件打包成独立JAR并通过依赖引入，而非直接在build脚本中定义类（脚本内定义的插件属于内部逻辑，不会被IDEA识别为已安装插件）：

1. 将插件代码放在buildSrc模块或独立插件项目中
2. 打包插件并发布到本地/远程仓库
3. 在目标项目中通过plugins块或buildscript引入：

// 示例：使用plugins DSL（需插件符合发布规范）
plugins {
    id 'com.yourcompany.mybuild' version '1.0'
}

// 或使用buildscript方式
buildscript {
    repositories {
        mavenLocal()
    }
    dependencies {
        classpath 'com.yourcompany:mybuild:1.0'
    }
}
apply plugin: 'com.yourcompany.mybuild'

完成后，IDEA的Gradle工具栏Plugins列表中就会显示你的自定义插件。

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