Qt C++ QWidget通过QRadioButton实现明暗主题切换方法

你之前的写法有两个致命问题：

1. 用本地相对路径./Combinear.qss加载样式，程序启动时工作目录不一定是可执行文件所在目录，90%概率找不到文件，而且你没做文件打开成功的判断，失败了也无提示
2. 没处理OpenGL窗口的样式适配，QOpenGLWidget默认不开启QSS背景绘制，就算样式加载成功也看不到效果

前置准备 #

• 准备两份QSS文件分别对应明暗主题，比如light.qss、dark.qss，把两个文件加入Qt资源文件(.qrc)，统一用资源路径访问，彻底避免路径错误问题
• 给所有继承自QOpenGLWidget的自定义控件加一行初始化代码：setAttribute(Qt::WA_StyledBackground, true);，开启样式背景支持

第一步：封装通用样式加载函数 #

把加载QSS的逻辑抽成公共函数，加错误判断：

#include <QFile>
#include <QApplication>
#include <QDebug>

bool loadAppStyle(const QString& qssResPath)
{
    QFile qssFile(qssResPath);
    if (!qssFile.open(QIODevice::ReadOnly | QIODevice::Text)) {
        qWarning() << "样式加载失败，错误信息：" << qssFile.errorString() << "路径：" << qssResPath;
        return false;
    }
    qApp->setStyleSheet(QLatin1String(qssFile.readAll()));
    qssFile.close();
    return true;
}

注意：qApp是Qt全局宏，直接指向当前应用的QApplication实例，不用额外传参

第二步：修复main函数初始化逻辑 #

启动时从你的Settings配置里读取上次保存的主题选择，自动加载对应样式：

int main(int argc, char *argv[])
{
    QSurfaceFormat fmt;
    fmt.setVersion(3,3);
    fmt.setProfile(QSurfaceFormat::CoreProfile);
    fmt.setSamples(8);
    fmt.setOption(QSurfaceFormat::StereoBuffers);
    fmt.setSwapBehavior(QSurfaceFormat::DoubleBuffer);
    QSurfaceFormat::setDefaultFormat(fmt);

    loadSettings();
    App app(argc, argv);

    // 从配置读取主题，默认加载浅色主题：0=浅色 1=深色
    int curTheme = Settings::instance()->value("theme_type", 0).toInt();
    if (curTheme == 1) {
        loadAppStyle(":/style/dark.qss");
        // 同步设置单选按钮选中状态，避免状态和实际主题不匹配
        Settings::instance()->ui->DarkTheme->setChecked(true);
    } else {
        loadAppStyle(":/style/light.qss");
        Settings::instance()->ui->lightTheme->setChecked(true);
    }

    MainWindow w;
    w.show();
    const auto returnValue = app.exec();
    App::setFinished();
    return returnValue;
}

第三步：实现两个单选按钮槽函数 #

切换样式时同步持久化配置，下次启动自动生效：

void Settings::on_DarkTheme_clicked()
{
    if (loadAppStyle(":/style/dark.qss")) {
        setValue("theme_type", 1);
        sync(); // 基于QSettings实现配置类时，调用sync立即写入配置
    }
}

void Settings::on_lightTheme_clicked()
{
    if (loadAppStyle(":/style/light.qss")) {
        setValue("theme_type", 0);
        sync();
    }
}

• 自定义重写paintEvent的控件如果样式不生效，在paintEvent最开头加如下代码，保证QSS正常绘制：

void CustomWidget::paintEvent(QPaintEvent* e)
{
    QStyleOption opt;
    opt.initFrom(this);
    QPainter p(this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
    // 后续写自定义绘制逻辑
}

• QSS语法不要用CSS3的高级特性，Qt只支持CSS2的部分子集，不支持的属性会被直接忽略
• 不要手动给控件调用setPalette设置调色板，调色板优先级高于QSS，会覆盖样式效果
• 如果父控件设置了样式，子控件选择器要写对，类名要完全匹配，继承的控件需要写对应类名选择器才能命中

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