PyQt5 QComboBox实现任意位置字符动态搜索的问题

不需要额外维护独立字符串列表，直接基于QComboBox自带的组件即可实现需求，以下分两种场景给出实现方案：

基础方案：修改默认Completer过滤模式 #

对于绝大多数任意位置匹配的场景，直接修改QCompleter的过滤模式即可，无需额外开发，内存开销可忽略：

PyQt5/PyQt6代码示例 #

from PyQt5.QtWidgets import QApplication, QComboBox, QWidget, QVBoxLayout
from PyQt5.QtCore import Qt

app = QApplication([])
window = QWidget()
layout = QVBoxLayout(window)

combo = QComboBox()
# 模拟从JSON加载100+选项
for i in range(150):
    combo.addItem(f"Item_{i}_Sample_{150-i}")

# 获取ComboBox默认的 completer
completer = combo.completer()
# 设置过滤模式为「包含匹配」，支持任意位置字符匹配
completer.setFilterMode(Qt.MatchContains)
# 保持弹出式完成模式（仅显示匹配选项）
completer.setCompletionMode(completer.PopupCompletion)

layout.addWidget(combo)
window.show()
app.exec_()

C++ Qt代码示例 #

#include <QApplication>
#include <QComboBox>
#include <QVBoxLayout>
#include <QWidget>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QWidget window;
    QVBoxLayout* layout = new QVBoxLayout(&window);

    QComboBox* combo = new QComboBox();
    // 模拟加载大量选项
    for(int i=0; i<150; ++i){
        combo->addItem(QString("Item_%1_Sample_%2").arg(i).arg(150-i));
    }

    QCompleter* completer = combo->completer();
    // 设置包含匹配模式，支持任意位置匹配
    completer->setFilterMode(Qt::MatchContains);
    // 保持弹出式完成模式
    completer->setCompletionMode(QCompleter::PopupCompletion);

    layout->addWidget(combo);
    window.show();
    return app.exec();
}

原理说明 #

• QComboBox默认的Completer过滤模式为Qt::MatchStartsWith，仅匹配字符串开头；改为Qt::MatchContains后，会匹配选项中任意位置的字符。
• 完全复用QComboBox的内置模型数据，无需额外维护字符串列表，100+选项的内存开销可以忽略。
• 保持PopupCompletion模式，输入时会动态弹出过滤后的匹配选项，符合需求。

进阶方案：正则表达式自定义匹配 #

如果需要更灵活的匹配规则（比如忽略大小写、复杂正则匹配），可以通过自定义代理模型实现，同样无需额外维护字符串列表：

PyQt代码示例 #

from PyQt5.QtWidgets import QApplication, QComboBox, QWidget, QVBoxLayout, QCompleter
from PyQt5.QtCore import Qt, QSortFilterProxyModel
import re

class RegexFilterProxyModel(QSortFilterProxyModel):
    def __init__(self, parent=None):
        super().__init__(parent)
        self._pattern = ""

    def setFilterPattern(self, pattern):
        self._pattern = pattern
        self.invalidateFilter()

    def filterAcceptsRow(self, source_row, source_parent):
        if not self._pattern:
            return True
        # 获取ComboBox中的选项文本
        index = self.sourceModel().index(source_row, 0, source_parent)
        text = self.sourceModel().data(index).lower()
        # 使用正则实现忽略大小写的任意位置匹配，可自定义正则规则
        return re.search(self._pattern.lower(), text) is not None

app = QApplication([])
window = QWidget()
layout = QVBoxLayout(window)

combo = QComboBox()
for i in range(150):
    combo.addItem(f"Item_{i}_Test_{150-i}")

# 创建自定义代理模型，复用ComboBox的原始模型
proxy_model = RegexFilterProxyModel()
proxy_model.setSourceModel(combo.model())

# 创建新的Completer并绑定代理模型
completer = QCompleter(proxy_model, combo)
completer.setCompletionMode(QCompleter.PopupCompletion)
# 监听输入框文本变化，实时更新过滤规则
combo.lineEdit().textChanged.connect(proxy_model.setFilterPattern)

combo.setCompleter(completer)

layout.addWidget(combo)
window.show()
app.exec_()

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