如何在IntelliJ插件Swing编辑器中实现自动补全文本提示

嘿，针对你在IntelliJ平台插件开发中遇到的编辑器补全弹窗问题，我给你梳理一套贴合平台原生风格的实现方案，完全不用你说的那种带窗口按钮的ComboBox～

IntelliJ平台本身就有一套成熟的补全框架，咱们不用从头造轮子，基于CompletionService和Lookup组件就能实现和IDE原生补全一致的弹窗效果，完全符合你要的无多余窗口按钮的需求。

1. 监听编辑器输入/快捷键触发 #

首先得让补全逻辑能被触发——要么用户手动按Ctrl+Space，要么输入内容时自动触发。

• 手动触发：继承EditorAction重写actionPerformed方法，把它绑定到Ctrl+Space快捷键上，这样用户手动唤起补全的逻辑就通了。
• 自动触发：给Editor绑定DocumentListener，在documentChanged方法里判断当前输入内容，符合条件就弹出补全框。

示例代码片段：

// 监听文档变化，自动触发补全
Document document = editor.getDocument();
document.addDocumentListener(new DocumentListener() {
    @Override
    public void documentChanged(DocumentEvent event) {
        // 这里可以加判断逻辑，比如输入的是特定前缀才触发
        int caretOffset = editor.getCaretModel().getOffset();
        String currentPrefix = document.getText(new TextRange(caretOffset - 2, caretOffset));
        if ("he".equals(currentPrefix)) { // 示例：输入"he"时触发
            showCompletionPopup(editor);
        }
    }
});

2. 构建补全候选并弹出原生弹窗 #

IntelliJ的Lookup组件就是原生补全弹窗的载体，完全没有多余的窗口按钮，样式和IDE自带补全一致。你只需要构建补全候选列表，再通过LookupManager创建并显示弹窗即可。

示例代码片段：

private void showCompletionPopup(Editor editor) {
    // 构建补全候选项，可自定义图标、描述
    List<LookupElement> candidates = new ArrayList<>();
    candidates.add(LookupElementBuilder.create("hello").withIcon(AllIcons.Nodes.Method));
    candidates.add(LookupElementBuilder.create("help").withIcon(AllIcons.Nodes.Class));
    candidates.add(LookupElementBuilder.create("heavy").withIcon(AllIcons.Nodes.Field));

    // 创建并显示补全弹窗
    LookupManager lookupManager = LookupManager.getInstance(editor.getProject());
    Lookup lookup = lookupManager.createLookup(editor, candidates, true);
    lookup.show();
}

3. 适配Editor嵌入JPanel的特殊场景 #

因为你把Editor嵌入到了JPanel里，需要确保弹窗能正确定位：

• 优先用IntelliJ平台的容器（比如ToolWindow、Dialog）承载你的JPanel，而不是纯Swing的JFrame，这样平台UI管理器能自动处理弹窗位置。
• 如果必须用纯Swing容器，可以通过Lookup.getPositionStrategy()手动设置弹窗位置，比如Lookup.PositionStrategy.BELOW_CARET，确保弹窗出现在光标下方。

4. 优化触发体验 #

如果做自动触发，记得优化逻辑避免频繁弹窗：

• 加个延迟判断，比如用户停止输入500ms后再触发补全（用SwingUtilities.invokeLater配合定时器实现）。
• 过滤掉空格、标点这类无意义输入，只在输入有效字符时触发。

额外小提示 #

• 别用Swing的ComboBox，IntelliJ的Lookup完全满足需求，还能和IDE风格统一，交互更自然。
• 可以参考IDE自带的JavaCompletionContributor源码，看看官方是怎么实现复杂补全逻辑的。
• 确保插件SDK依赖里已经引入了com.intellij.codeInsight.completion相关模块。

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