Qt QCompleter无法弹出：中文拼音匹配人名补全问题

要实现拼音片段匹配中文人名的QCompleter补全，核心是自定义过滤逻辑，让QCompleter能关联拼音映射而非仅匹配字符串本身。我们可以通过QSortFilterProxyModel重写过滤规则，结合拼音-人名的映射表来实现需求。

实现步骤 #

1. 维护拼音全拼与中文人名的映射关系；
2. 自定义代理模型，重写filterAcceptsRow方法，判断输入的拼音片段是否存在于对应人名的全拼中；
3. 将代理模型绑定到QCompleter，关联到输入框。

完整C++代码示例 #

#include <QApplication>
#include <QLineEdit>
#include <QCompleter>
#include <QStringListModel>
#include <QSortFilterProxyModel>
#include <QHash>

// 自定义代理模型，处理拼音片段过滤
class PinyinFilterProxyModel : public QSortFilterProxyModel
{
    Q_OBJECT
public:
    explicit PinyinFilterProxyModel(QObject *parent = nullptr)
        : QSortFilterProxyModel(parent)
    {}

    // 设置拼音-人名映射表
    void setPinyinNameMap(const QHash<QString, QString>& map) {
        m_pinyinNameMap = map;
        // 构建人名到拼音的反向映射，方便快速查找
        m_namePinyinMap.clear();
        for (auto it = m_pinyinNameMap.constBegin(); it != m_pinyinNameMap.constEnd(); ++it) {
            m_namePinyinMap.insert(it.value(), it.key());
        }
    }

protected:
    // 重写过滤规则：判断输入的片段是否在对应人名的拼音中
    bool filterAcceptsRow(int source_row, const QModelIndex& source_parent) const override {
        QModelIndex index = sourceModel()->index(source_row, 0, source_parent);
        QString name = sourceModel()->data(index).toString();
        QString pinyin = m_namePinyinMap.value(name);

        // 忽略大小写，检查拼音是否包含当前过滤字符串
        return pinyin.contains(filterRegExp().pattern(), Qt::CaseInsensitive);
    }

private:
    QHash<QString, QString> m_pinyinNameMap; // 拼音->人名
    QHash<QString, QString> m_namePinyinMap; // 人名->拼音
};

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    // 1. 准备拼音-人名映射数据
    QHash<QString, QString> pinyinNameMap;
    pinyinNameMap.insert("lvbu", "吕布");
    pinyinNameMap.insert("lvbuwei", "吕不韦");

    // 2. 创建原始模型存储人名列表
    QStringList nameList = pinyinNameMap.values();
    QStringListModel* sourceModel = new QStringListModel(nameList);

    // 3. 创建自定义代理模型并设置映射
    PinyinFilterProxyModel* proxyModel = new PinyinFilterProxyModel();
    proxyModel->setSourceModel(sourceModel);
    proxyModel->setPinyinNameMap(pinyinNameMap);
    proxyModel->setFilterRole(Qt::DisplayRole);
    proxyModel->setFilterCaseSensitivity(Qt::CaseInsensitive);

    // 4. 创建QCompleter并绑定代理模型
    QCompleter* completer = new QCompleter(proxyModel);
    completer->setCompletionMode(QCompleter::PopupCompletion);
    completer->setCaseSensitivity(Qt::CaseInsensitive);

    // 5. 创建输入框并关联补全器
    QLineEdit* lineEdit = new QLineEdit();
    lineEdit->setCompleter(completer);
    lineEdit->setPlaceholderText("输入拼音片段，比如lv或bu");
    lineEdit->resize(300, 30);
    lineEdit->show();

    // 监听输入框文本变化，同步更新代理模型的过滤规则
    QObject::connect(lineEdit, &QLineEdit::textChanged, [proxyModel](const QString& text) {
        proxyModel->setFilterRegExp(QRegExp(text, Qt::CaseInsensitive, QRegExp::FixedString));
    });

    return a.exec();
}

#include "main.moc"

代码说明 #

• PinyinFilterProxyModel：核心是重写filterAcceptsRow，将输入的拼音片段与对应人名的全拼进行匹配，只要全拼包含该片段就保留为候选。
• 双向映射表：同时维护拼音到人名、人名到拼音的映射，避免频繁遍历查找，提升匹配效率。
• 过滤规则：使用FixedString模式的正则匹配，确保输入的片段作为普通字符串匹配，避免正则特殊字符干扰。

测试时输入lv或bu，QCompleter会弹出"吕布"和"吕不韦"的补全候选，符合需求。

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