Jetbrains插件SDK：如何为全系列IDE添加工具栏动作

方案1：针对不同IDE配置专属组ID #

不同JetBrains IDE的主工具栏运行组ID存在差异，你可以在plugin.xml中通过条件判断为每个IDE指定对应的group-id，避开硬编码通用ID的局限性：

<actions>
  <action id="YourPluginActionId" class="com.your.package.YourActionClass" text="你的动作名称">
    <!-- IDEA（社区版/旗舰版） -->
    <add-to-group group-id="ToolBarRunGroup" anchor="last" />
    <!-- Rider -->
    <add-to-group group-id="MainToolBar.RunGroup" anchor="last">
      <product name="RD" />
    </add-to-group>
    <!-- PyCharm/WebStorm等其他IDE，可通过UI Inspector查对应组ID后添加 -->
    <add-to-group group-id="ToolBarRunGroup" anchor="last">
      <product name="PC" />
      <product name="WS" />
    </add-to-group>
  </action>
</actions>

• 各IDE的product code可查JetBrains官方文档，比如Rider是RD、PyCharm是PC、WebStorm是WS。
• 针对新IDE，仍可通过Internal Actions -> UI inspector定位目标工具栏组ID，补充到配置中即可。

方案2：动态代码注册动作到工具栏 #

如果不想维护多份静态配置，可以通过代码在插件启动时，动态识别当前IDE并找到合适的工具栏组，将动作添加进去：

1. 实现ApplicationStartupListener监听插件启动事件：

import com.intellij.openapi.actionSystem.ActionManager;
import com.intellij.openapi.actionSystem.AnAction;
import com.intellij.openapi.actionSystem.DefaultActionGroup;
import com.intellij.openapi.application.Application;
import com.intellij.openapi.application.ApplicationStartupListener;
import org.jetbrains.annotations.NotNull;

public class ToolbarActionRegistrar implements ApplicationStartupListener {
    @Override
    public void applicationStarted(@NotNull Application application) {
        ActionManager actionManager = ActionManager.getInstance();
        AnAction targetAction = actionManager.getAction("YourPluginActionId");
        if (targetAction == null) return;

        // 遍历所有动作组，匹配工具栏中与运行相关的组
        for (var actionGroup : actionManager.getActionGroups()) {
            String groupId = actionManager.getId(actionGroup);
            if (groupId == null) continue;
            // 匹配IDEA的ToolBarRunGroup和Rider的MainToolBar.RunGroup，可扩展其他IDE的组ID规则
            if (groupId.contains("ToolBarRun") || groupId.contains("MainToolBar.Run")) {
                if (actionGroup instanceof DefaultActionGroup) {
                    ((DefaultActionGroup) actionGroup).add(targetAction);
                    break;
                }
            }
        }
    }
}

2. 在plugin.xml中注册这个监听器：

<extensions defaultExtensionNs="com.intellij">
    <applicationStartupListener implementation="com.your.package.ToolbarActionRegistrar" />
</extensions>

• 这种方式可自动适配不同IDE，无需静态配置多个group-id，但要确保在应用启动完成后执行注册逻辑，避免UI线程问题。

方案3：尝试通用主工具栏组（备选） #

部分IDE支持直接将动作添加到MainToolBar根组，通过指定相对位置控制显示位置：

<add-to-group group-id="MainToolBar" anchor="after" relative-to-action="Run"/>

不过这种方式在不同IDE中显示位置可能不一致，适合对位置要求不高的场景，可作为前两种方案的补充。

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