如何在IntelliJ插件中为所有编辑器添加焦点/失焦监听器？

嘿，我来帮你搞定IntelliJ插件里监听所有编辑器焦点与失焦事件的事儿！下面是经过实践验证的实现思路和代码示例：

核心思路 #

IntelliJ平台提供了FocusManager（全局焦点管理）和EditorFactory（编辑器生命周期管理）两大核心API，结合这两个就能覆盖已存在的编辑器和后续新打开的编辑器的焦点监听需求。

具体实现步骤 #

1. 全局焦点监听（捕获所有组件的焦点变化） #

通过全局FocusManager注册焦点监听器，过滤出编辑器相关的组件，处理焦点获取/失去事件：

• 调用FocusManager.getInstance(project)获取对应项目的焦点管理器
• 注册FocusAdapter，在focusGained和focusLost回调中判断组件是否为编辑器组件

2. 编辑器生命周期监听（覆盖新创建的编辑器） #

因为全局焦点监听无法自动监听后续打开的编辑器，所以需要通过EditorFactory监听编辑器的创建事件，给新编辑器的内容组件单独添加焦点监听器：

• 调用EditorFactory.getInstance().addEditorListener()注册编辑器监听器
• 在editorCreated回调中，获取编辑器的内容组件，添加焦点监听

完整代码示例 #

import com.intellij.openapi.editor.Editor;
import com.intellij.openapi.editor.EditorFactory;
import com.intellij.openapi.editor.event.EditorAdapter;
import com.intellij.openapi.editor.event.EditorEvent;
import com.intellij.openapi.project.Project;
import com.intellij.openapi.wm.FocusManager;
import com.intellij.ui.components.JBEditorTextField;

import java.awt.Component;
import java.awt.event.FocusAdapter;
import java.awt.event.FocusEvent;

public class GlobalEditorFocusListener {

    private static FocusAdapter globalFocusAdapter;
    private static EditorAdapter editorCreatedAdapter;

    // 注册监听的入口方法，建议在插件启动时调用（比如StartupActivity或ProjectComponent中）
    public static void registerListeners(Project project) {
        // 全局焦点监听
        globalFocusAdapter = new FocusAdapter() {
            @Override
            public void focusGained(FocusEvent e) {
                Component source = e.getComponent();
                if (isEditorComponent(source)) {
                    onEditorFocusGained(source);
                }
            }

            @Override
            public void focusLost(FocusEvent e) {
                Component source = e.getComponent();
                if (isEditorComponent(source)) {
                    onEditorFocusLost(source);
                }
            }
        };
        FocusManager.getInstance(project).addFocusListener(globalFocusAdapter);

        // 新编辑器创建监听
        editorCreatedAdapter = new EditorAdapter() {
            @Override
            public void editorCreated(EditorEvent event) {
                Editor editor = event.getEditor();
                Component editorContent = editor.getContentComponent();
                // 给新编辑器的内容组件添加焦点监听
                editorContent.addFocusListener(new FocusAdapter() {
                    @Override
                    public void focusGained(FocusEvent e) {
                        onEditorFocusGained(e.getComponent());
                    }

                    @Override
                    public void focusLost(FocusEvent e) {
                        onEditorFocusLost(e.getComponent());
                    }
                });
            }
        };
        EditorFactory.getInstance().addEditorListener(editorCreatedAdapter);
    }

    // 移除监听，避免内存泄漏，建议在项目关闭时调用
    public static void unregisterListeners(Project project) {
        if (globalFocusAdapter != null) {
            FocusManager.getInstance(project).removeFocusListener(globalFocusAdapter);
        }
        if (editorCreatedAdapter != null) {
            EditorFactory.getInstance().removeEditorListener(editorCreatedAdapter);
        }
    }

    // 判断组件是否为编辑器相关组件，可根据需求扩展判断逻辑
    private static boolean isEditorComponent(Component component) {
        // 匹配普通文本编辑器的内容组件，以及JBEditorTextField（比如弹窗里的编辑器）
        return component instanceof JBEditorTextField ||
               (component != null && component.getClass().getName().contains("EditorComponentImpl"));
    }

    // 编辑器获得焦点的业务逻辑，替换成你自己的代码
    private static void onEditorFocusGained(Component editorComponent) {
        System.out.println("编辑器获得焦点：" + editorComponent.toString());
        // 比如：记录当前激活的编辑器、更新插件UI状态等
    }

    // 编辑器失去焦点的业务逻辑，替换成你自己的代码
    private static void onEditorFocusLost(Component editorComponent) {
        System.out.println("编辑器失去焦点：" + editorComponent.toString());
        // 比如：保存编辑器状态、触发自动格式化等
    }
}

关键注意事项 #

• 插件启动时注册监听：可以通过StartupActivity（项目启动时执行）或者ProjectComponent的projectOpened方法调用registerListeners
• 避免内存泄漏：一定要在项目关闭时调用unregisterListeners，移除所有注册的监听器
• 精确匹配编辑器组件：isEditorComponent方法可以根据你的需求调整，比如直接通过instanceof判断编辑器内容组件的具体类（IntelliJ内部类是EditorComponentImpl）
• 区分项目级和全局级：如果需要监听所有项目的编辑器，可使用FocusManager.getGlobalInstance()，但一般插件都是针对单个项目的，所以用项目级的FocusManager更合适

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