idea plugin插件开发——入门级教程（IntelliJ IDEA Plugin）

手打不易，如果转摘，请注明出处！

注明原文：idea plugin插件开发——入门级教程（IntelliJ IDEA Plugin）-CSDN博客

---

目录

前言

官方

官方文档

代码示例

开发前必读

Intellij、Gradle、JDK 版本关系

plugin.xml 配置介绍

开发第一个插件

初始化项目工程

创建ToolWindow

注册ToolWindow

运行和调试

打包和发布

修改开源插件Restful-Toolkit

新增导出工具类

创建一个导出按钮

TreePanelWindow添加按钮

常用API

获取plugin.xml里面配置的类

获取选择的文件夹和项目

获取鼠标所在的元素

获取方法的参数

踩坑问题

问题：Cannot start compilation: the output path is not specified for module "zj-idea-plugin-gradle-run-test".

相关文章推荐

---

前言

有时候想开发一款自己的idea插件，但是无从下手，这篇文章就是教你如何入门！

官方

官方文档

IntelliJ Platform SDK | IntelliJ Platform Plugin SDK

代码示例

https://github.com/JetBrains/intellij-sdk-code-samples

开发前必读

Intellij、Gradle、JDK 版本关系

环境搭建第一步先确认好自己的Intellij IDEA和Gradle之间的版本关系，找到对应的版本才能保证不出现冲突报错。

通过gradle开发idea插件，环境版本适配_idea 指定gradle版本-CSDN博客

plugin.xml 配置介绍

<idea-plugin><!-- 插件的id，id全局唯一 --><id>com.example.zhang</id><!-- 插件的名称和版本, 会在idea插件界面显示 --><name>example</name><version>1.0</version><!-- 作者信息 --><vendor email="[e-mail]" url="http://www.zhang.com">www.zhang.com</vendor><!-- 插件描述,要大于40个字符--><description>This is my ABCDEFGHIJKLMNOPQRSTUVWXYZ plugins, it is convenient for us to...</description><!-- 插件版本更新记录 --><change-notes><![CDATA[<ul><li><b>Version 1.0.1</b> Convert to ABCDEFGHIJKLMNOPQRSTUVWXYZ plugin</li><li><b>Version 1.0.0</b> Release 2020 and earlier.</li></ul>]]></change-notes><!-- 兼容的idea版本 --><idea-version since-build="191.0"/><!-- 依赖模块 --><depends>com.intellij.modules.platform</depends><!-- 插件扩展 --><extensions defaultExtensionNs="com.intellij"><!-- 例如 toolWindow、executor 都可以在这里定义 --><!-- 插件定义的自定义操作，例如菜单项、工具栏按钮等。每个操作都有一个唯一的 id，一个实现类 class，以及可选的快捷键定义 --></extensions><!-- 插件具备哪些动作按钮 --><actions><!-- 例如 各种action 都可以在这里定义 --><!-- 插件定义的自定义操作，例如菜单项、工具栏按钮等。每个操作都有一个唯一的 id，一个实现类 class，以及可选的快捷键定义 --></actions><!-- 定义一些初始化 Component,高版本已弃用 --><project-components><!-- Component --></project-components>
</idea-plugin>

开发第一个插件

初始化项目工程

前提是需要把JDK、Gradle、IDEA都安装好，网上有多教程，这里不再赘述。

打开IntelliJ IDEA，新建一个IDE Plugin工程。

整体目录结构大致如下，冗余的配置可以删掉

先修改 gradle-wrapper.properties 中的gradle版本，例如：

idea、jdk、gradle用什么版本，之前已经提到了，参考：

通过gradle开发idea插件，环境版本适配_idea 指定gradle版本-CSDN博客

distributionBase=GRADLE_USER_HOMEdistributionPath=wrapper/distsdistributionUrl=https\://services.gradle.org/distributions/gradle-x.x.x-bin.zipzipStoreBase=GRADLE_USER_HOMEzipStorePath=wrapper/dists

修改 build.gradle 文件（如果不存在就新建）

一般 gradle 中的 repositories 是必须修改的，否则网络不通。

dependencies 依赖包和 intellij 的version根据自己的实际情况选择。

buildscript {repositories {maven {// 内网maven库地址，下载依赖的第三方库url 'http://xxxxxxxxxx/artifactory/maven-public/'}maven {// 内网JetBrains仓库，下载依赖的IDE和jdk等，用于编译和运行插件url 'http://xxxxxxxxxx/artifactory/jetbrains-public/'}}dependencies {// gradle-intellij-plugin用于构建JetBrains插件, 请确保始终升级到最新版本classpath "org.jetbrains.intellij.plugins:gradle-intellij-plugin:0.6.5"}
}plugins {id 'java'id 'org.jetbrains.intellij' version '0.4.10'id "org.jetbrains.kotlin.jvm" version "1.3.41"
}group 'org.example'
version '1.0-SNAPSHOT'repositories {maven {url 'http://xxxxxxxxxxxxxxxxx/artifactory/maven-public/'}
}dependencies {implementation 'com.alibaba:druid:1.2.8'
}// See https://github.com/JetBrains/gradle-intellij-plugin/
intellij {version '2019.3.5'// 必须,否则无法找到 PsiClass 等plugins = ['java', 'gradle']intellij.updateSinceUntilBuild false
}sourceCompatibility = 1.8
targetCompatibility = 1.8apply {"java""terminal""ant"
}test {useJUnitPlatform()
}tasks.withType(JavaCompile) {options.encoding = "UTF-8"
}buildPlugin {buildSearchableOptions.enabled = false
}

修改plugin.xml 的配置内容

注意 idea-version since-build 兼容版本，可以不写，也可以根据你现在开发的版本来指定。

例如，build.gradle 中，我指定的2019老版本开发的.

查询官网版本信息：

Other Versions - IntelliJ IDEA

内容如下：

<!-- Plugin Configuration File. Read more: https://plugins.jetbrains.com/docs/intellij/plugin-configuration-file.html -->
<idea-plugin><!-- 插件的id，id全局唯一 --><id>com.example.myFirstIdeaPlugin</id><!-- 插件的名称和版本, 会在idea插件界面显示 --><name>MY_FIRST_IDEA_PLUGIN</name><version>1.0</version><!-- 作者信息 --><vendor email="[e-mail]" url="http://www.zhang.com">www.zhang.com</vendor><!-- 插件描述,要大于40个字符--><description>This is my ABCDEFGHIJKLMNOPQRSTUVWXYZ plugins, it is convenient for us to...</description><!-- 插件版本更新记录 --><change-notes><![CDATA[<ul><li><b>Version 1.0.1</b> Convert to ABCDEFGHIJKLMNOPQRSTUVWXYZ plugin</li><li><b>Version 1.0.0</b> Release 2020 and earlier.</li></ul>]]></change-notes><!-- 兼容的idea版本 --><idea-version since-build="193.7288.26"/><!-- 依赖模块 --><depends>com.intellij.modules.platform</depends>
</idea-plugin>

对应实际发布后的插件关系如下：

idea的的gradle setting配置如下：

配置完成后，建议重新打开IDEA，或者重新初始化一下gradle，如果IDEA未能找到gradle项目，按照下面的方法区添加。

到这里，我们就完成了项目工程的创建和初始化。

创建ToolWindow

我们参考官方教程，来做一个日历插件：

https://github.com/JetBrains/intellij-sdk-code-samples/tree/main/tool_window/src/main/java/org/intellij/sdk/toolWindow

这里可能比官方教程稍微详细一点。

我们先创建好2个目录：

创建ToolWindow其实就是把面板界面和交互实现，IDEA有个快速创建UI的方法，对目录右键：

弹框后直接输入名字，并选择绑定class

idea会创建好form和对应的class，我们只需要在这个上面编辑我们要的组件即可。

最终我们添加了3个JLabel和2个JButton，注意组件需要填写对应的file name，以便在class类中添加成员属性。

我们看下自动创建好的类 MyCalendarForm.class

package com.example.myfirstideaplugin.calendar.ui;import javax.swing.JButton;
import javax.swing.JLabel;
import javax.swing.JPanel;public class MyCalendarForm {private JPanel panel;private JButton refreshButton;private JButton hideButton;private JLabel timeZone;private JLabel time;private JLabel date;
}

需要实现一个方法来获取时间，同时对刷新按钮和隐藏按钮添加监听器，图标可以通过 setIcon() 来设置。

最终代码如下：

package com.example.myfirstideaplugin.calendar.ui;import com.intellij.openapi.wm.ToolWindow;import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.util.Calendar;
import java.util.Objects;import javax.swing.ImageIcon;
import javax.swing.JButton;
import javax.swing.JLabel;
import javax.swing.JPanel;public class MyCalendarForm {private JPanel panel;private JButton refreshButton;private JButton hideButton;private JLabel timeZone;private JLabel time;private JLabel date;public MyCalendarForm(ToolWindow toolWindow) {// 隐藏按钮 监听器hideButton.addActionListener(new ActionListener() {@Overridepublic void actionPerformed(ActionEvent e) {toolWindow.hide(null);}});// 刷新按钮 监听器refreshButton.addActionListener(new ActionListener() {@Overridepublic void actionPerformed(ActionEvent e) {timeTime();}});// 初始化调用this.timeTime();}public void timeTime() {// 获取年月日, 并设置 iconCalendar instance = Calendar.getInstance();int day = instance.get(Calendar.DAY_OF_MONTH);int month = instance.get(Calendar.MONTH) + 1;int year = instance.get(Calendar.YEAR);time.setText(day + "/" + month + "/" + year);time.setIcon(new ImageIcon(Objects.requireNonNull(getClass().getResource("/icon/calendar/Calendar-icon.png"))));// 获取时分, 并设置 iconint minute = instance.get(Calendar.MINUTE);int hour = instance.get(Calendar.HOUR_OF_DAY);int second = instance.get(Calendar.SECOND);String min = (minute < 10) ? "0" + minute : String.valueOf(minute);String sec = (second < 10) ? "0" + second : String.valueOf(second);date.setText(hour + ":" + min + ":" + sec);date.setIcon(new ImageIcon(Objects.requireNonNull(getClass().getResource("/icon/calendar/Time-icon.png"))));// 获取时区long gmtOffset = instance.get(Calendar.ZONE_OFFSET); // offset from GMT in millisecondsString strGmtOffset = String.valueOf(gmtOffset / 3600000);String temp = (gmtOffset > 0) ? "GMT + " + strGmtOffset : "GMT - " + strGmtOffset;timeZone.setText(temp);timeZone.setIcon(new ImageIcon(Objects.requireNonNull(getClass().getResource("/icon/calendar/Time-zone-icon.png"))));}public JPanel getContent() {return panel;}}

到这里，我们把UI和交互写好了，接下来我们要实现 ToolWindowFactory 方法，来定义一个ToolWindow。

package com.example.myfirstideaplugin.calendar.factory;import com.example.myfirstideaplugin.calendar.ui.MyCalendarForm;
import com.intellij.openapi.project.Project;
import com.intellij.openapi.wm.ToolWindow;
import com.intellij.openapi.wm.ToolWindowFactory;
import com.intellij.ui.content.Content;
import com.intellij.ui.content.ContentFactory;import org.jetbrains.annotations.NotNull;public class CalendarToolWindowFactory implements ToolWindowFactory {/*** Create the tool window content.** @param project    current project* @param toolWindow current tool window*/@Overridepublic void createToolWindowContent(@NotNull Project project, @NotNull ToolWindow toolWindow) {MyCalendarForm MyCalendarForm = new MyCalendarForm(toolWindow);ContentFactory contentFactory = ContentFactory.SERVICE.getInstance();// createContent()参数一定是 JComponent 的子类Content content = contentFactory.createContent(MyCalendarForm.getContent(), "我的日历", false);toolWindow.getContentManager().addContent(content);}
}

至此，一个日历ToolWindow就写好了。接下来只需要注册就可以使用。

注册ToolWindow

注册ToolWindow，其实就是去plugin.xml绑定一下ToolWindow，包括id、icon、位置等信息。

在 plugin.xml 中添加如下代码

    <!-- 插件扩展 --><extensions defaultExtensionNs="com.intellij"><!-- — — — — — — — — — 示例:日历toolWindow BEGIN— — — — — — — — — --><!-- 参考官方demo:https://github.com/JetBrains/intellij-sdk-code-samples/tree/main/tool_window --><!-- canCloseContents 是否允许用户关闭 --><toolWindow id="我的calendar" icon="/icon/calendar/Calendar-icon.png"anchor="bottom" canCloseContents="true"factoryClass="com.example.myfirstideaplugin.calendar.factory.CalendarToolWindowFactory"></toolWindow></extensions>

id是该ToolWindow的唯一键，icon是指定图标，anchor表示我们想显示在哪个位置。

运行和调试

调试运行的方式如下：

可以看到，我们的插件生效了.

每次点击刷新，可以刷新时间

打包和发布

打包只需要执行buildPlugin即可

打包后的目录和包在这里：

这个zip文件就是我们要的插件安装包，直接安装到IntelliJ IDEA，重启就可以使用了，

如果想要发布到官方的IntelliJ IDEA插件，直接去官方上传，审核通过后就可以发布全网。

修改开源插件Restful-Toolkit

https://github.com/EzioL/plugin-restful-toolkit

有时候项目很老，没有yaml去定义各个API接口，只有Controller。

因此我们希望有个插件，能帮助我们一键导出项目所有的API接口。

新增导出工具类

package com.ezio.plugin.utils;import com.ezio.plugin.navigator.pojo.ApiInModule;
import com.ezio.plugin.navigator.pojo.ApiInfo;import java.io.BufferedWriter;
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLDecoder;
import java.util.List;public enum FileUtl {;public static String getCurResourcePath(Class<?> cls) {String currPath = "";try {currPath = URLDecoder.decode(cls.getResource("").getPath(), "UTF-8");} catch (UnsupportedEncodingException e) {e.printStackTrace();}String str = "file:/";currPath = currPath.substring(str.length());return currPath.substring(0, currPath.indexOf("build"));}public static void writeStr(String filePath, List<ApiInModule> apiInModuleList) {File logFile = new File(filePath);// 先判断日志目录是否存在,不存在则先创建if (!logFile.getParentFile().exists()) {boolean mkdirFlag = logFile.getParentFile().mkdirs();if (!mkdirFlag) {throw new RuntimeException("创建文件失败:" + logFile.getParentFile());}}try (BufferedWriter bw = new BufferedWriter(new FileWriter(logFile))) {bw.write("");for (ApiInModule apiInModule : apiInModuleList) {List<ApiInfo> apiInfoList = apiInModule.getApiInfoList();for (ApiInfo apiInfo : apiInfoList) {String fullUrl = apiInfo.getFullUrl();bw.append(fullUrl).append("\n");}}} catch (IOException e) {System.out.println("error:" + e);}}
}

创建一个导出按钮

代码如下：

package com.ezio.plugin.utils;import com.ezio.plugin.navigator.pojo.ApiInModule;
import com.ezio.plugin.navigator.pojo.ApiInfo;import java.io.BufferedWriter;
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLDecoder;
import java.util.List;public enum FileUtl {;public static String getCurResourcePath(Class<?> cls) {String currPath = "";try {currPath = URLDecoder.decode(cls.getResource("").getPath(), "UTF-8");} catch (UnsupportedEncodingException e) {e.printStackTrace();}String str = "file:/";currPath = currPath.substring(str.length());return currPath.substring(0, currPath.indexOf("build"));}public static void writeStr(String filePath, List<ApiInModule> apiInModuleList) {File logFile = new File(filePath);// 先判断日志目录是否存在,不存在则先创建if (!logFile.getParentFile().exists()) {boolean mkdirFlag = logFile.getParentFile().mkdirs();if (!mkdirFlag) {throw new RuntimeException("创建文件失败:" + logFile.getParentFile());}}try (BufferedWriter bw = new BufferedWriter(new FileWriter(logFile))) {bw.write("");for (ApiInModule apiInModule : apiInModuleList) {List<ApiInfo> apiInfoList = apiInModule.getApiInfoList();for (ApiInfo apiInfo : apiInfoList) {String fullUrl = apiInfo.getFullUrl();bw.append(fullUrl).append("\n");}}} catch (IOException e) {System.out.println("error:" + e);}}
}

TreePanelWindow添加按钮

在com.ezio.plugin.toolwindow.TreePanelWindow 类下面添加Action，

actionGroup.add(new ExportToolBar());

public class TreePanelWindow extends SimpleToolWindowPanel implements DataProvider {private SimpleTree myTree;public TreePanelWindow(SimpleTree tree) {super(true, true);this.myTree = tree;// 设置 tree 线条JBColor color = new JBColor(new Color(11, 6, 39),new Color(36, 38, 39));myTree.setBorder(BorderFactory.createLineBorder(color));// 设置 scrollPane 线条JScrollPane scrollPane = ScrollPaneFactory.createScrollPane(myTree);scrollPane.setBorder(BorderFactory.createLineBorder(JBColor.RED));setContent(scrollPane);final ActionManager actionManager = ActionManager.getInstance();// 设置 toolbar action, 添加一个刷新按钮// createActionToolbar(String place, ActionGroup group, boolean horizontal)DefaultActionGroup actionGroup = new DefaultActionGroup();actionGroup.add(actionManager.getAction("zhang.group.refresh"));actionGroup.add(new ExportToolBar());ActionToolbar actionToolbar = actionManager.createActionToolbar("myPlace", actionGroup, false);setToolbar(actionToolbar.getComponent());myTree.addMouseListener(new TreePanelWindowListener());}
}

常用API

获取plugin.xml里面配置的类

 ServiceManager.getService(XXXX.class);

获取选择的文件夹和项目

IdeView ideView = (IdeView)anActionEvent.getRequiredData(LangDataKeys.IDE_VIEW);
//选择的文件夹
this.psiDirectory = ideView.getOrChooseDirectory();
//选择的项目
this.project = this.psiDirectory.getProject();
获取选中的类名
//  e为 AnActionEvent 
PsiFile psiFile = e.getData(CommonDataKeys.PSI_FILE);
//获取选中的类名
String name = psiFile.getVirtualFile().getName();

获取鼠标所在的元素

PsiElement psiElement = e.getData(PlatformDataKeys.PSI_ELEMENT);

获取方法的参数

PsiParameter[] psiParameters = ((PsiMethodImpl) psiElement).getParameterList().getParameters();

获取指定文件名的文件

PsiFile[] psiFiles = FilenameIndex.getFilesByName(project, name, GlobalSearchScope.projectScope(project));

踩坑问题

问题：Cannot start compilation: the output path is not specified for module "zj-idea-plugin-gradle-run-test".

Specify the output path in the Project Structure dialog.

运行代码的时候报错如下：

解决：

如图所示，再Project Structure里面的Modules修改Paths，路径为当前目录\target\classes和\target\test-classes

相关文章推荐

idea plugin插件开发1——idea底部窗口(带按钮)_idea下方工具窗口 开发-CSDN博客

idea plugin插件开发2——预览代码(多窗口)_idea预览代码-CSDN博客

idea plugin插件开发3——可编辑表单_idea 插件开发filechooserfactory-CSDN博客

推荐10款高频插件

1. ​Rainbow Brackets
   功能：为代码中的括号（如圆括号、方括号、花括号）添加彩色高亮，帮助开发者更清晰地识别嵌套结构。
   适用场景：适用于任何需要清晰识别括号嵌套的编程语言，特别适合嵌套较深的代码。
   官网：Rainbow Brackets - IntelliJ IDEs Plugin | Marketplace
    
2. Generate All Getter And Setter
   功能：快速为POJO类生成所有getter和setter方法，支持带默认值和不带默认值的setter方法。
   适用场景：适用于需要快速生成Java类的getter和setter方法的场景。
   官网：Generate All Getter And Setter - IntelliJ IDEs Plugin | Marketplace
    
3. Gsonformat
   功能：将JSON字符串格式化为Gson格式的Java类，支持自定义类名和包名。
   适用场景：适用于需要将JSON数据快速转换为Java类的场景。
   官网：Gsonformat - IntelliJ IDEs Plugin | Marketplace
    
4. MyBatisCodeHelperPro
   功能：为MyBatis框架提供代码生成和辅助功能，包括SQL语句生成、Mapper接口生成等。
   适用场景：适用于使用MyBatis框架的Java项目。
   官网：MyBatisCodeHelperPro - IntelliJ IDEs Plugin | Marketplace
    
5. Statistic
   功能：提供代码统计功能，包括行数、单词数、字符数等统计信息。
   适用场景：适用于需要快速统计代码量的场景。
   官网：Statistic - IntelliJ IDEs Plugin | Marketplace
    
6. RESTFul-Tool
   功能：提供RESTful API的测试和调试工具，支持HTTP请求发送、响应查看等。
   适用场景：适用于开发和调试RESTful API。
   官网：RESTFul-Tool - IntelliJ IDEs Plugin | Marketplace
    
7. Maven Helper
   功能：增强Maven项目的管理功能，支持依赖分析、依赖树查看、依赖冲突解决等。
   适用场景：适用于使用Maven构建的Java项目。
   官网：Maven Helper - IntelliJ IDEs Plugin | Marketplace
    
8. Java Mybatis SQL Scanner
   功能：扫描MyBatis的SQL语句，检测潜在的错误和问题，支持自定义规则。
   适用场景：适用于使用MyBatis框架的Java项目，特别是需要对SQL语句进行静态分析的场景。
   官网：Java Mybatis SQL Scanner - IntelliJ IDEs Plugin | Marketplace
    
9. Power Mode II （酷炫风）
   功能：为IDEA添加动态效果，如代码输入时的震动、闪光等，增加编程的乐趣。
   适用场景：适用于任何需要增加编程乐趣的场景。
   官网：Power Mode II - IntelliJ IDEs Plugin | Marketplace
    
10. Arthas Idea
    功能：集成Arthas（一个Java诊断工具）到IntelliJ IDEA中，支持在线调试、监控和诊断Java应用。
    适用场景：适用于需要在线调试和监控Java应用的场景。
    官网：arthas idea - IntelliJ IDEs Plugin | Marketplace
    这些插件可以帮助你更高效地进行Java开发，提升代码质量和开发体验。根据你的具体需求，选择合适的插件进行安装和使用。