IDEA-插件开发踩坑记录-第六坑-UAST依赖问题

背景

简要说明：

UAST – Unified Abstract Syntax Tree

UAST (Unified Abstract Syntax Tree) is an abstraction layer on the PSI of different programming languages targeting the JVM (Java Virtual Machine). It provides a unified API for working with common language elements like classes and method declarations, literal values, and control flow operators.

大意：

UAST（统一抽象语法树）是针对JVM （Java虚拟机）的不同编程语言的PSI上的抽象层。它提供了一个统一的API，用于处理公共语言元素，如类和方法声明、文字值和控制流操作符。

你如果用到了PSI与JAVA相关的东西，都可能出现我这个问题；当然类似其他PSI抽象也可以参考这个解决办法。

在JetBrains-intellij-idea 插件开发时，编译正常，运行不正常的奇怪问题；

插件开发依赖版本（申明了依赖JAVA）：

intellij {
    version.set("2024.1.7")
    type.set("IC") // Target IDE Platform
    # 此处申明了需要依赖java
    plugins.set(listOf("com.intellij.java"))
}

问题现象

编译正常，运行到 PsiMethod部分报错；

异常堆栈关键信息

#c.i.i.p.PluginManager - com/intellij/psi/PsiMethod
java.lang.NoClassDefFoundError: com/intellij/psi/PsiMethod

......

Caused by: java.lang.ClassNotFoundException: com.intellij.psi.PsiMethod PluginClassLoader(plugin=PluginDescriptor

......

结论

插件依赖需要检查三个步骤：JetBrains官方说明

1. 确定 Plugin ID

2. 检查项目设置

3. 在plugin.xml中定义；

如果编译正常，运行出现 java.lang.NoClassDefFoundError一般而言是遗漏了第三个步骤。

解决办法很简单：在plugin.xml中添加如下内容：

<depends>com.intellij.java</depends>