如何设置Qt程序从非EXE目录加载依赖DLL？

由于QWebEngine模块的加载逻辑与普通Qt模块存在差异，常规的库路径设置方法可能无法完全覆盖其依赖查找需求，以下是针对该场景的可行解决方案：

方案1：临时修改系统PATH环境变量 #

QWebEngine部分核心组件依赖系统PATH查找底层DLL，可在应用启动时临时将目标依赖目录加入PATH：

#include <windows.h>
#include <QCoreApplication>

int main(int argc, char *argv[])
{
    // 替换为你的依赖DLL目录
    const QString targetDllDir = R"(D:\MyAppDeps\QtLibs)";

    // 获取当前PATH
    wchar_t currentPath[MAX_PATH];
    GetEnvironmentVariableW(L"PATH", currentPath, MAX_PATH);
    
    // 拼接新PATH（将目标目录放在最前面优先查找）
    QString newPath = targetDllDir + ";" + QString::fromWCharArray(currentPath);
    SetEnvironmentVariableW(L"PATH", newPath.toStdWString().c_str());

    QApplication app(argc, argv);
    // 后续业务代码
    return app.exec();
}

方案2：单独配置QWebEngine依赖路径 #

QWebEngine有独立的依赖查找逻辑，可通过设置环境变量指定其专属依赖目录：

#include <QCoreApplication>

int main(int argc, char *argv[])
{
    // 指定QWebEngine专属依赖目录（需包含webengine相关DLL、locales、resources子目录）
    qputenv("QTWEBENGINE_PATH", R"(D:\MyAppDeps\WebEngine)");
    
    // 设置通用Qt库路径
    QCoreApplication::addLibraryPath(R"(D:\MyAppDeps\QtLibs)");

    QApplication app(argc, argv);
    // 后续业务代码
    return app.exec();
}

注意：需用windeployqt将QWebEngine相关资源单独部署到指定目录，命令示例：

windeployqt --dir D:\MyAppDeps\WebEngine --release --webengine MyApp.exe

方案3：完善qt.conf配置 #

若使用qt.conf，需确保配置覆盖所有Qt模块的路径规则，示例配置（放在EXE同目录）：

[Paths]
Prefix = D:/MyAppDeps/QtRoot
Library = lib
Plugins = plugins
Qml = qml
WebEngine = webengine

• Prefix为Qt依赖的根目录，其子目录需与windeployqt部署后的结构完全匹配
• 若qt.conf不在EXE目录，可通过QT_QT_CONF_PATH环境变量指定其路径

关键注意事项 #

• 所有路径配置代码必须在QApplication/QGuiApplication实例化前执行
• 确保目标目录包含MSVC运行时库（如vcruntime140.dll等），可通过VS的vcpkg或单独复制部署
• 部署完成后，可通过Dependency Walker工具检查缺失的DLL

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