IntelliJ SDK创建集成终端RunConfiguration遇类缺失错误求助

我需要创建一个RunConfiguration，让命令通过powershell.exe或cmd.exe这类终端程序在IDE集成终端中运行。尝试过使用GlobalCommandLine和PtyCommandLine，但它们都是直接创建独立进程，不会通过指定的终端程序执行命令。

之后我参考ShTerminalRunner类的实现来开发功能，该类依赖org.jetbrains.plugins.terminal包中的ShellTerminalWidget。我已经在build.gradle.kts中添加了terminal插件依赖：

plugins.set(listOf(
    "terminal"
))

但运行时出现以下错误：

java.lang.NoClassDefFoundError: org/jetbrains/plugins/terminal/TerminalToolWindowManager
    at code.sh.ShTerminalRunner.run(ShTerminalRunner.kt:29)
    at code.sh.runconfig.FlowRunConfiguration$getState$1.startProcess(FlowRunConfiguration.kt:29)
    at com.intellij.execution.configurations.CommandLineState.execute(CommandLineState.java:61)
    at com.intellij.execution.runners.DefaultRunProgramRunner$execute$1.invoke(DefaultRunProgramRunner.kt:29)
    at ... stack trace
Caused by: java.lang.ClassNotFoundException: org.jetbrains.plugins.terminal.TerminalToolWindowManager PluginClassLoader(plugin=PluginDescriptor(name=Pon, id=code.sh, descriptorPath=plugin.xml, path=~\Documents\IdeaProjects\Pon\build\idea-sandbox\plugins\Pon, version=1.0-SNAPSHOT, package=null, isBundled=false), packagePrefix=null, state=active)
    at com.intellij.ide.plugins.cl.PluginClassLoader.loadClass(PluginClassLoader.kt:156)
    at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:525)
    ... 46 more

注：代码直接复制自IntelliJ社区版的ShTerminalRunner实现。

解决方法 #

1. 补充plugin.xml中的依赖声明 #

仅在build.gradle.kts中添加插件依赖不足以让IntelliJ插件系统加载关联类，必须在plugin.xml中明确声明对terminal插件的依赖：

<depends>org.jetbrains.plugins.terminal</depends>

这一步能确保插件类加载器可以访问terminal插件提供的所有类。

2. 检查API版本兼容性 #

不同版本的IntelliJ Platform中，Terminal相关API可能存在变更。如果使用的是较新的平台版本，确认TerminalToolWindowManager是否被迁移、重命名或替换。可以查阅对应版本的IntelliJ Platform SDK文档确认API状态。

3. 使用正确的服务获取方式 #

避免直接实例化TerminalToolWindowManager，改用IntelliJ的服务获取机制来获取实例，确保类加载上下文正确：

val terminalManager = TerminalToolWindowManager.getInstance(project)

4. 清理并重启Sandbox环境 #

有时Sandbox环境可能没有正确加载依赖插件，尝试以下操作：

• 清理Sandbox目录（通常在项目的build/idea-sandbox路径下）
• 重新构建插件并重启IDE运行环境

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