如何从EditorPopupMenu注册的Action中访问自定义ToolWindow内的组件？

我之前做IntelliJ插件开发时也碰到过这个棘手的问题——依赖UI层级遍历组件不仅反直觉，还特别脆弱，改个布局代码就崩了。其实完全不用受限于这种方式，有几种更优雅且健壮的方案能解决组件访问的问题：

1. 自定义ToolWindowFactory，持有面板实例 #

GUI Designer生成的面板类（比如MyToolWindowPanel）本身就包含了所有组件的引用，只是默认是private的。我们可以通过自定义ToolWindowFactory，在创建ToolWindow内容时把这个面板实例保存下来，后续Action直接调用即可，完全不用遍历UI层级。

示例代码：
首先创建自定义的ToolWindowFactory：

public class MyToolWindowFactory implements ToolWindowFactory {
    // 若支持多项目，更推荐用ProjectService绑定实例到当前Project，避免静态变量冲突
    private static MyToolWindowPanel toolWindowPanel;

    @Override
    public void createToolWindowContent(@NotNull Project project, @NotNull ToolWindow toolWindow) {
        ContentManager contentManager = toolWindow.getContentManager();
        // 实例化GUI Designer生成的面板
        toolWindowPanel = new MyToolWindowPanel();
        Content content = contentManager.getFactory().createContent(toolWindowPanel, "", false);
        contentManager.addContent(content);
    }

    // 提供方法供Action获取面板实例
    public static MyToolWindowPanel getToolWindowPanel() {
        return toolWindowPanel;
    }
}

然后在你的右键菜单Action里直接调用：

public class MyPopupAction extends AnAction {
    @Override
    public void actionPerformed(@NotNull AnActionEvent e) {
        Project project = e.getProject();
        if (project == null) return;
        
        // 直接拿到面板实例
        MyToolWindowPanel panel = MyToolWindowFactory.getToolWindowPanel();
        // 直接访问GUI Designer中命名的组件（若组件是private，建议给面板添加getter方法）
        panel.myTextField.setText("Updated value from popup!");
    }
}

2. 利用DataContext传递组件引用 #

IntelliJ平台的DataContext机制可以让你在Action中轻松获取当前上下文的对象，不用硬编码查找。我们可以在ToolWindow的面板中实现DataProvider，把需要更新的组件或面板实例注入到DataContext里。

示例代码：
先让面板类实现DataProvider：

public class MyToolWindowPanel extends JPanel implements DataProvider {
    // GUI Designer生成的组件
    private JTextField myTextField;
    // 自定义DataKey，提前在公共类中定义
    public static final DataKey<MyToolWindowPanel> MY_PANEL = DataKey.create("MyToolWindow.Panel");
    public static final DataKey<JTextField> MY_TEXT_FIELD = DataKey.create("MyToolWindow.TextField");

    public MyToolWindowPanel() {
        $$$setupUI$$$(); // GUI Designer自动生成的初始化方法
    }

    @Override
    public @Nullable Object getData(@NotNull String dataId) {
        if (MY_PANEL.is(dataId)) {
            return this;
        }
        if (MY_TEXT_FIELD.is(dataId)) {
            return myTextField;
        }
        return super.getData(dataId);
    }
}

然后在Action中获取：

public class MyPopupAction extends AnAction {
    @Override
    public void actionPerformed(@NotNull AnActionEvent e) {
        // 从DataContext获取面板实例
        MyToolWindowPanel panel = e.getData(MyToolWindowPanel.MY_PANEL);
        if (panel != null) {
            panel.myTextField.setText("Updated via DataContext!");
        }
        
        // 也可以直接获取单个组件
        JTextField textField = e.getData(MyToolWindowPanel.MY_TEXT_FIELD);
        if (textField != null) {
            textField.setText("Updated directly!");
        }
    }
}

这种方式更贴合IntelliJ平台的设计思想，扩展性更强，适合需要和多个UI组件交互的场景。

3. 优化GUI Designer组件的访问权限 #

默认情况下，GUI Designer生成的组件是private的，我们可以在设计界面调整权限：右键组件 → 选择"Properties" → 在"Modifier"下拉框改成package-private（不推荐直接用public，建议给面板添加getter方法封装）。这样拿到面板实例后，就能直接访问组件，不用反射或遍历。

为什么原来的方案不可取？ #

你提到的通过ContentManager获取JPanel再遍历的方式，本质是依赖UI的物理结构——一旦调整布局（比如把组件移到其他容器、新增Tab页），getContent(0)或遍历逻辑就会直接失效，维护成本极高。而上面的方案都是基于组件实例引用而非UI层级，完全不受布局变化的影响。

总结下来，推荐第一种或第二种方案：第一种简单直接，适合小型插件；第二种更符合IntelliJ的架构设计，适合复杂项目。

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