无法使用JetBrains UI Libraries：IntelliJ插件运行时类缺失问题

我正在开发IntelliJ IDEA社区版插件，采用Java语言与Gradle构建工具，此前使用Java Swing库开发UI并成功部署插件。现在尝试使用com.intellij.ui.*等JetBrains库及图标时，编译阶段可正常调用UI组件，但运行时抛出NoClassDefFoundError：

Exception in thread "main" java.lang.NoClassDefFoundError: com/intellij/ui/components/JBLabel
    at Test.main(Test.java:8)
Caused by: java.lang.ClassNotFoundException: com.intellij.ui.components.JBLabel
    at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
    at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188)
    at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:525)
    ... 1 more

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':Test.main()'.
> Process 'command '/home/dharun/.jdks/jbr-17.0.11/bin/java'' finished with non-zero exit value 1

我推测是运行时找不到对应类库，已尝试更换项目JDK、检查依赖，但问题仍存在。使用main方法执行时，Swing的JLabel可正常创建，JetBrains的JBLabel却不行。

1. 修正Gradle依赖配置 #

IntelliJ插件的核心依赖必须通过官方intellijGradle插件管理，而非普通implementation声明。确保build.gradle配置如下：

plugins {
    id 'java'
    id 'org.jetbrains.intellij' version '1.17.3' // 选用与IDE版本兼容的最新插件版本
}

intellij {
    version '2024.1' // 匹配你开发目标的社区版IDE版本
    type 'IC' // 明确指定社区版
}

sourceCompatibility = '17' // 与IDE内置JDK版本保持一致

com.intellij.ui类属于IDE核心模块，通过intellij插件会自动处理编译和运行时的依赖关联，避免类路径缺失。

2. 避免用普通main方法测试插件UI #

JBLabel等JetBrains UI组件依赖IntelliJ IDE的运行环境，无法脱离IDE通过普通Java main方法执行——普通程序的类加载器无法识别IDE内部的类结构。

正确测试方式：

• 使用IntelliJ自带的Run Plugin配置，启动一个独立的IDE实例，在实例中验证插件功能
• 编写插件测试类，继承LightPlatform4TestCase，通过IDE测试框架运行用例

3. 检查依赖作用域 #

如果手动添加过IDE相关依赖，确保不要使用compileOnly作用域，否则运行时不会将该依赖加入类路径：

// 错误示例：仅编译时可用，运行时缺失
compileOnly 'com.intellij:idea-community:2024.1'

// 推荐方式：通过intellij插件管理，无需手动声明核心依赖

4. 同步依赖并清理缓存 #

执行以下Gradle命令确保依赖正确下载：

./gradlew clean buildPlugin
./gradlew sync

同时清理IntelliJ缓存：File -> Invalidate Caches... -> Invalidate and Restart

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