QT4迁移至QT6：QXT扩展库组件的QT6替代方案咨询

以下是针对你用到的QXT组件，给出的QT6原生/轻量封装替代方案，尽量保证代码改动量最小：

QxtStringSpinBox #

QXT的该组件是支持循环切换字符串选项的旋转框，QT6无原生对应组件，可通过继承QSpinBox轻量封装实现：

class StringSpinBox : public QSpinBox
{
    Q_OBJECT
public:
    explicit StringSpinBox(QWidget* parent = nullptr) : QSpinBox(parent) {}
    void setStrings(const QStringList& strings) { m_strings = strings; setRange(0, m_strings.size()-1); }
protected:
    QString textFromValue(int val) const override { return m_strings.value(val); }
    int valueFromText(const QString& text) const override { return m_strings.indexOf(text); }
private:
    QStringList m_strings;
};

替换时只需将QxtStringSpinBox改为StringSpinBox，调用setStrings()替代原设置选项的接口即可。

QxtTimer #

QT6的QTimer完全兼容QxtTimer的核心功能（单次触发、间隔重复、启停控制），直接全局替换类名即可：

• 将所有QxtTimer改为QTimer
• 原接口如start()、stop()、setInterval()、singleShot()均与QT原生一致，无需额外修改。

QxtConfigDialog & QxtConfigWidget #

QXT的这两个组件用于配置页的管理与持久化，可通过QDialog + QTabWidget + QSettings组合替代：

1. 用QTabWidget作为配置页容器，对应QxtConfigWidget的页管理功能；
2. 每个配置页用普通QWidget承载控件；
3. 保存/加载配置时，通过QSettings读写键值对，封装成类似loadSettings()、saveSettings()的方法，对齐原QxtConfigWidget的接口。
   若要进一步减少改动，可封装一个轻量的ConfigWidget类，对外暴露与QxtConfigWidget一致的addPage()、load()、save()方法，内部复用QSettings逻辑。

QxtGroupBox #

若QxtGroupBox是带折叠/展开功能的分组框，可通过继承QGroupBox封装折叠逻辑实现：

class CollapsibleGroupBox : public QGroupBox
{
    Q_OBJECT
public:
    explicit CollapsibleGroupBox(const QString& title, QWidget* parent = nullptr) : QGroupBox(title, parent)
    {
        setCheckable(true);
        connect(this, &QGroupBox::toggled, this, &CollapsibleGroupBox::toggleContent);
    }
    void setContentWidget(QWidget* widget) { m_content = widget; }
private slots:
    void toggleContent(bool checked) { if(m_content) m_content->setVisible(checked); }
private:
    QWidget* m_content = nullptr;
};

替换时将QxtGroupBox改为CollapsibleGroupBox，调用setContentWidget()设置分组内的内容控件即可。

QxtToolTip #

QT6原生QToolTip已支持自定义样式与显示控制，直接替换即可：

• 原自定义提示样式可通过QToolTip::setStyleSheet()实现；
• 若需延迟显示，可结合QTimer控制QToolTip::showText()的调用时机，无需额外封装。

QxtSignalWaiter #

QXT的该组件用于同步等待信号触发，QT6可用QEventLoop直接实现，或封装成轻量工具类：

class SignalWaiter
{
public:
    static bool wait(QObject* sender, const char* signal, int timeout = 30000)
    {
        QEventLoop loop;
        QTimer timer;
        timer.setSingleShot(true);
        QObject::connect(&timer, &QTimer::timeout, &loop, &QEventLoop::quit);
        QObject::connect(sender, signal, &loop, &QEventLoop::quit);
        timer.start(timeout);
        loop.exec();
        return timer.isActive();
    }
};

替换原QxtSignalWaiter::wait()调用为SignalWaiter::wait()即可，参数完全兼容。

QxtLogger、QxtXmlFileLoggerEngine、QxtBasicFileLoggerEngine #

QT6原生QLoggingCategory + 自定义消息处理器可替代QXT的日志系统：

1. 定义日志类别，区分不同级别（debug/info/error）；
2. 自定义消息处理器，将日志写入文件，支持文本或XML格式：

void customMessageHandler(QtMsgType type, const QMessageLogContext& context, const QString& msg)
{
    // 按需求格式化日志（文本或XML）
    QString logStr = QString("[%1] %2").arg(QDateTime::currentDateTime().toString(Qt::ISODate)).arg(msg);
    // 写入文件
    QFile file("app.log");
    if(file.open(QIODevice::Append | QIODevice::Text))
    {
        QTextStream stream(&file);
        stream << logStr << endl;
    }
}

3. 在程序启动时注册处理器：qInstallMessageHandler(customMessageHandler);
   若要对齐原QxtLogger的接口，可封装一个Logger类，对外暴露debug()、info()、error()等方法，内部调用QT原生日志接口。

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