QSyntaxHighlighter的rehighlight()忽略其他线程触发变更问题求助

看起来你遇到的问题是Qt版本升级后，跨线程触发的语法高亮功能失效——在5.6.2里正常工作，到5.9.5（Win10/OS X环境）就不行了。结合Qt的版本迭代变化，我梳理了几个大概率的原因和对应的解决方案：

1. 跨线程信号连接的线程上下文问题 #

Qt 5.7之后对UI线程的安全性检查变得更严格。你的拼写检查线程属于后台线程，直接将spellcheck()信号连接到rehighlight()的操作，在5.6.2里可能默认用了队列连接，但5.9+版本中如果使用Qt::AutoConnection，可能因为线程判断逻辑的变化，导致信号直接在后台线程调用UI相关方法。而QSyntaxHighlighter的操作必须在主线程执行，这就会导致高亮不生效。

解决方法：显式指定队列连接，确保UI操作在主线程执行：

// 替换原来的信号连接代码
connect(spellCheckThread, &SpellCheckThread::spellcheck, 
        highlighter, &QSyntaxHighlighter::rehighlight,
        Qt::QueuedConnection);

2. QTextDocument的脏标记机制变化 #

Qt 5.9+对QTextDocument的内容脏标记逻辑做了调整，有时候rehighlight()可能无法主动触发文档内容的重新解析。你可以手动强制标记文档为脏，让高亮器重新处理所有内容：

修改高亮器的rehighlight方法：

void MyHighlighter::rehighlight()
{
    if (QTextDocument* doc = document()) {
        // 标记整个文档内容为脏，强制触发重新高亮
        doc->markContentsDirty(0, doc->characterCount());
    }
    // 调用父类的默认实现
    QSyntaxHighlighter::rehighlight();
}

3. 高亮格式被默认样式覆盖 #

Qt 5.9之后的QTextEdit/QPlainTextEdit默认样式可能有调整，导致你设置的红色前景色被系统默认样式覆盖。可以检查你的highlightBlock()方法里的格式设置，确保优先级足够：

确保格式设置正确且优先级生效：

void MyHighlighter::highlightBlock(const QString &text)
{
    QTextCharFormat errorFormat;
    errorFormat.setForeground(Qt::red);
    // 设置全宽选中属性，提升样式优先级
    errorFormat.setProperty(QTextFormat::FullWidthSelection, true);
    // 将样式应用到整个文本块
    setFormat(0, text.length(), errorFormat);
}

快速排查步骤 #

• 先在主线程直接调用highlighter->rehighlight()，观察红色高亮是否生效。如果生效，那问题肯定出在跨线程连接上，用队列连接即可解决。
• 如果主线程调用也不生效，检查highlightBlock()是否被触发（可以加qDebug()输出验证），以及格式设置是否正确。

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