如何使用addItem()更新JComboBox且不改变选中项

方法一：临时移除再恢复监听器 #

更新选项前先把CaretListener拿掉，操作完再装回去，这样更新过程不会触发监听器，从根源避免循环。

final JTextField tfListText = (JTextField) comboBox1.getEditor().getEditorComponent();
CaretListener caretListener = new CaretListener() {
    private String lastText;

    @Override
    public void caretUpdate(CaretEvent e) {
        String text = tfListText.getText();
        if (!text.equals(lastText)) {
            lastText = text;
            // 临时移除监听器
            tfListText.removeCaretListener(this);
            
            comboBox1.removeAllItems();
            // 根据输入文本获取匹配项
            List<String> matchedItems = getMatchedItems(text);
            for (String item : matchedItems) {
                comboBox1.addItem(item);
            }
            // 恢复编辑器里的输入文本，避免清空选项时被重置
            tfListText.setText(text);
            
            // 重新添加监听器
            tfListText.addCaretListener(this);
        }
    }
};
tfListText.addCaretListener(caretListener);

方法二：用标志位跳过监听器逻辑 #

加个布尔标记，更新选项时把标记设为true，监听器里检测到这个标记就直接跳过逻辑，避免循环触发。

final JTextField tfListText = (JTextField) comboBox1.getEditor().getEditorComponent();
final boolean[] isUpdating = {false}; // 用数组保证内部类能修改值

tfListText.addCaretListener(new CaretListener() {
    private String lastText;

    @Override
    public void caretUpdate(CaretEvent e) {
        if (isUpdating[0]) {
            return; // 正在更新，直接跳过
        }
        String text = tfListText.getText();
        if (!text.equals(lastText)) {
            lastText = text;
            isUpdating[0] = true;
            
            comboBox1.removeAllItems();
            List<String> matchedItems = getMatchedItems(text);
            for (String item : matchedItems) {
                comboBox1.addItem(item);
            }
            tfListText.setText(text); // 恢复输入文本
            
            isUpdating[0] = false;
        }
    }
});

方法三：改用DocumentListener（更推荐） #

CaretListener只要光标动就触发，哪怕文本没改，而DocumentListener只在文本内容真的变化时才响应，逻辑更精准，能减少无效触发。

final JTextField tfListText = (JTextField) comboBox1.getEditor().getEditorComponent();
final boolean[] isUpdating = {false};

tfListText.getDocument().addDocumentListener(new DocumentListener() {
    @Override
    public void insertUpdate(DocumentEvent e) {
        updateComboBoxItems();
    }

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

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

    private void updateComboBoxItems() {
        if (isUpdating[0]) {
            return;
        }
        String text = tfListText.getText();
        isUpdating[0] = true;
        
        comboBox1.removeAllItems();
        List<String> matchedItems = getMatchedItems(text);
        for (String item : matchedItems) {
            comboBox1.addItem(item);
        }
        tfListText.setText(text);
        
        isUpdating[0] = false;
    }
});

额外注意点 #

• 如果匹配项数据量大，把获取匹配项的逻辑放到异步线程里，避免UI卡住，更新UI时要通过SwingUtilities.invokeLater()回到Swing事件调度线程。
• 不管有没有匹配项，都保留用户输入的文本在编辑器里，体验更友好。

内容的提问来源于stack exchange，提问作者IceCream-jy