QT5中加载与.qss样式表同目录图片的技术解决方案咨询

QT加载QSS时会将其视为纯字符串，无法自动关联样式表文件的路径，所以默认会以当前工作目录解析图片的相对路径。你当前切换工作目录的方法确实有副作用，这里提供两种更合理的替代方案：

方案一：预处理QSS内容，替换相对路径为绝对路径 #

读取QSS文件后，自动将其中的图片相对路径替换为基于样式表所在目录的绝对路径，无需修改工作目录。

代码示例：

if (!KreatorSettings::instance().customTheme().isNull()) {
    QString qsFileName = KreatorSettings::instance().customTheme();
    QFile qfFile(qsFileName);
    if (qfFile.exists() && qfFile.open(QFile::ReadOnly | QFile::Text)) {
        QString qssContent = QLatin1String(qfFile.readAll());
        QFileInfo styleFileInfo(qsFileName);
        QString styleDir = styleFileInfo.absolutePath() + "/";

        // 正则匹配QSS中的url()表达式，替换相对路径
        QRegExp urlRegex(R"(url\((.*?)\))");
        int pos = 0;
        while ((pos = urlRegex.indexIn(qssContent, pos)) != -1) {
            QString imgPath = urlRegex.cap(1).trimmed();
            // 跳过绝对路径和QT资源路径（以:/开头）
            if (!QFileInfo(imgPath).isAbsolute() && !imgPath.startsWith(":/")) {
                QString absImgPath = styleDir + imgPath;
                qssContent.replace(pos, urlRegex.matchedLength(), QString("url(%1)").arg(absImgPath));
                pos += absImgPath.length() + 4; // 跳过替换后的内容长度，避免重复匹配
            } else {
                pos += urlRegex.matchedLength();
            }
        }

        qApp->setStyleSheet(qssContent);
        loadedCustom = true;
    }
}

这个方案的优势是用户编写的QSS可以保持原本的相对路径写法，程序自动完成路径转换，完全不影响当前工作目录。

方案二：临时注册样式表目录为QT资源 #

可以将样式表所在目录临时注册为QT资源，这样QSS中可以用类似资源文件的路径（如:/theme/icon_checkbox_checked.png）加载图片，无需修改路径写法。

代码示例：

if (!KreatorSettings::instance().customTheme().isNull()) {
    QString qsFileName = KreatorSettings::instance().customTheme();
    QFileInfo styleFileInfo(qsFileName);
    QString styleDir = styleFileInfo.absolutePath();

    // 临时注册目录为资源，前缀设为/theme
    // 需提前用rcc工具将目录打包为theme.rcc
    QResource::registerResource(styleDir + "/theme.rcc");

    // 读取并设置QSS，QSS中图片路径写:/theme/xxx.png
    QFile qfFile(qsFileName);
    if (qfFile.exists() && qfFile.open(QFile::ReadOnly | QFile::Text)) {
        qApp->setStyleSheet(QLatin1String(qfFile.readAll()));
        loadedCustom = true;
    }

    // 程序退出时可取消注册（可选）
    // QResource::unregisterResource(styleDir + "/theme.rcc");
}

如果需要动态注册目录内容（无需提前打包.rcc），可以通过QDirIterator遍历目录文件，手动构建QResource对象，不过代码会相对复杂一些。

补充说明 #

QT本身没有提供直接设置QSS路径根目录的API，上述两种方案都是通过间接手段解决路径解析问题。其中方案一是最适合用户自定义场景的，不需要用户修改QSS的写法，也没有工作目录相关的副作用。

内容的提问来源于stack exchange，提问作者Marino Šimić