如何为JTextArea实现自动补全功能？

SwingX自带的AutoCompleteDecorator原生设计目标是适配JTextField这类单行文本组件，直接作用于多行的JTextArea时存在天然逻辑缺陷，对应碰到的两个异常的根因：

• 严格模式（strictMatch=true）下，组件会对输入域的全量文本做强制匹配校验，输入完第一个单词后，后续输入的空格、新字符和候选列表的完整项不匹配，会被输入拦截逻辑直接屏蔽，导致无法继续输入
• 非严格模式下，补全触发逻辑仅绑定了组件首次聚焦、第一次输入的全量文本匹配事件，完成一次补全操作后，不会重新监听光标位置的局部输入变化，因此后续输入不会再弹出补全建议

直接放弃使用AutoCompleteDecorator.decorate(textArea, keys, false)的调用方式，基于Swing原生API实现轻量的自动补全逻辑即可，完全适配多行文本输入场景，没有上述兼容问题。

核心实现逻辑 #

• 给JTextArea的Document绑定文本变更监听器，每次输入变化时，定位光标当前位置，提取正在输入的当前单词片段（而非整个文本域的全部内容）
• 用提取到的单词前缀和候选词列表做前缀匹配，过滤出符合要求的补全建议
• 在光标位置下方弹出无焦点的JPopupMenu展示建议列表，支持上下方向键切换选项、Tab/回车确认补全、Esc关闭菜单
• 补全时仅替换当前正在输入的单词片段，不影响文本域其他位置的内容，不拦截空格、换行等正常输入操作

可直接运行的核心实现代码 #

import javax.swing.*;
import javax.swing.event.DocumentEvent;
import javax.swing.event.DocumentListener;
import javax.swing.text.BadLocationException;
import java.awt.*;
import java.awt.event.*;
import java.util.*;
import java.util.List;
import java.util.stream.Collectors;

public class TextAreaAutoCompleter {
    private final JTextArea textArea;
    private final List<String> candidateWords;
    private final JPopupMenu popupMenu;
    private final JList<String> suggestionList;
    private static final int MAX_SUGGESTION_COUNT = 8;

    public TextAreaAutoCompleter(JTextArea textArea, List<String> candidateWords) {
        this.textArea = textArea;
        // 候选词去重排序，提升匹配效率
        this.candidateWords = new ArrayList<>(new HashSet<>(candidateWords));
        Collections.sort(this.candidateWords);
        this.popupMenu = new JPopupMenu();
        this.suggestionList = new JList<>();
        initComponent();
        bindEvent();
    }

    private void initComponent() {
        popupMenu.setFocusable(false);
        suggestionList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
        suggestionList.setFocusable(false);
        JScrollPane scrollPane = new JScrollPane(suggestionList);
        scrollPane.setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER);
        popupMenu.add(scrollPane);
    }

    private void bindEvent() {
        // 监听文本变更触发补全更新
        textArea.getDocument().addDocumentListener(new DocumentListener() {
            @Override
            public void insertUpdate(DocumentEvent e) {
                refreshSuggestions();
            }

            @Override
            public void removeUpdate(DocumentEvent e) {
                refreshSuggestions();
            }

            @Override
            public void changedUpdate(DocumentEvent e) {
                refreshSuggestions();
            }
        });

        // 绑定键盘操作逻辑
        textArea.addKeyListener(new KeyAdapter() {
            @Override
            public void keyPressed(KeyEvent e) {
                if (!popupMenu.isVisible()) return;
                int selectedIndex = suggestionList.getSelectedIndex();
                int listSize = suggestionList.getModel().getSize();
                // 方向键下切换选项
                if (e.getKeyCode() == KeyEvent.VK_DOWN) {
                    e.consume();
                    int next = selectedIndex >= listSize - 1 ? 0 : selectedIndex + 1;
                    suggestionList.setSelectedIndex(next);
                    suggestionList.ensureIndexIsVisible(next);
                }
                // 方向键上切换选项
                else if (e.getKeyCode() == KeyEvent.VK_UP) {
                    e.consume();
                    int prev = selectedIndex <= 0 ? listSize - 1 : selectedIndex - 1;
                    suggestionList.setSelectedIndex(prev);
                    suggestionList.ensureIndexIsVisible(prev);
                }
                // 回车、Tab确认补全
                else if (e.getKeyCode() == KeyEvent.VK_ENTER || e.getKeyCode() == KeyEvent.VK_TAB) {
                    e.consume();
                    insertCompletion();
                }
                // Esc关闭补全菜单
                else if (e.getKeyCode() == KeyEvent.VK_ESCAPE) {
                    e.consume();
                    popupMenu.setVisible(false);
                }
            }
        });

        // 鼠标点击选项直接补全
        suggestionList.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent e) {
                insertCompletion();
            }
        });
    }

    // 提取光标位置当前输入的单词前缀
    private String getCurrentWordPrefix() throws BadLocationException {
        int caretPos = textArea.getCaretPosition();
        int wordStart = caretPos;
        // 向前遍历到单词边界（空白字符、文本起始位置为边界）
        while (wordStart > 0) {
            char prevChar = textArea.getText(wordStart - 1, 1).charAt(0);
            if (Character.isWhitespace(prevChar)) break;
            wordStart--;
        }
        return textArea.getText(wordStart, caretPos - wordStart);
    }

    // 刷新补全建议列表
    private void refreshSuggestions() {
        SwingUtilities.invokeLater(() -> {
            try {
                String prefix = getCurrentWordPrefix();
                if (prefix.isBlank()) {
                    popupMenu.setVisible(false);
                    return;
                }
                // 前缀匹配过滤候选词
                List<String> matched = candidateWords.stream()
                        .filter(word -> word.toLowerCase().startsWith(prefix.toLowerCase()))
                        .limit(MAX_SUGGESTION_COUNT)
                        .collect(Collectors.toList());
                if (matched.isEmpty()) {
                    popupMenu.setVisible(false);
                    return;
                }
                // 更新列表数据并显示菜单
                suggestionList.setListData(matched.toArray(new String[0]));
                suggestionList.setSelectedIndex(0);
                Rectangle caretPos = textArea.modelToView2D(textArea.getCaretPosition()).getBounds();
                popupMenu.show(textArea, caretPos.x, caretPos.y + caretPos.height);
                popupMenu.setPopupSize(200, suggestionList.getPreferredSize().height);
            } catch (BadLocationException ex) {
                popupMenu.setVisible(false);
            }
        });
    }

    // 插入选中的补全内容
    private void insertCompletion() {
        String selectedWord = suggestionList.getSelectedValue();
        if (selectedWord == null) return;
        try {
            int caretPos = textArea.getCaretPosition();
            int wordStart = caretPos;
            while (wordStart > 0) {
                char prevChar = textArea.getText(wordStart - 1, 1).charAt(0);
                if (Character.isWhitespace(prevChar)) break;
                wordStart--;
            }
            // 替换当前输入的前缀为完整补全词
            textArea.getDocument().remove(wordStart, caretPos - wordStart);
            textArea.getDocument().insertString(wordStart, selectedWord, null);
            popupMenu.setVisible(false);
        } catch (BadLocationException ex) {
            ex.printStackTrace();
        }
    }
}

调用方式 #

移除原有SwingX的AutoCompleteDecorator调用，直接实例化补全类绑定目标JTextArea即可：

// 候选词列表
List<String> keys = Arrays.asList("apple", "application", "apply", "banana", "band", "cat");
JTextArea textArea = new JTextArea();
// 绑定自动补全逻辑
new TextAreaAutoCompleter(textArea, keys);

该实现不存在SwingX装饰器的两个兼容问题：多单词连续输入、空格换行输入不会被拦截，每次输入都会实时触发当前位置的补全匹配，交互逻辑和常规IDE的自动补全一致，且纯原生Swing API实现，无额外第三方依赖。

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