qmake环境下如何创建兼容Debug/Release双配置链接的DLL

前置必要约束 #

仅修改编译参数无法完全实现兼容，必须先满足接口要求：

• DLL对外导出接口禁止跨边界传递CRT内置类型（如FILE*、需外部释放的堆内存指针）、STL容器/类型、Qt非接口类实例，所有跨DLL的内存分配、释放操作必须在DLL内部闭环，仅使用原生C基础类型、纯虚接口类作为跨边界交互载体。
• 导出接口的内联实现不得涉及CRT、STL、Qt的调试版本专属逻辑。

具体qmake配置 #

MinGW编译环境下Debug/Release默认ABI兼容，正常编译Release版本DLL即可直接适配两种用户配置，无需额外参数。以下配置针对MSVC编译器场景：

1. 强制启用Release编译模式，清除Debug模式默认配置：

CONFIG += release
CONFIG -= debug debug_and_release build_all
DEFINES -= _DEBUG
DEFINES += NDEBUG

2. 强制绑定Release版多线程动态CRT，清除调试版CRT依赖：

msvc {
    QMAKE_CFLAGS_RELEASE += /MD
    QMAKE_CXXFLAGS_RELEASE += /MD
    QMAKE_LFLAGS_RELEASE += /OPT:REF /OPT:ICF
    # 移除默认配置里可能带入的调试版CRT库链接项
    QMAKE_LIBS_CORE -= msvcrtd.lib msvcprtd.lib libcmtd.lib
    QMAKE_LIBS_GUI -= msvcrtd.lib msvcprtd.lib libcmtd.lib
    QMAKE_LIBS_WIDGETS -= msvcrtd.lib msvcprtd.lib libcmtd.lib
}

3. 关闭调试输出，避免引入调试版符号依赖：

DEFINES += QT_NO_DEBUG_OUTPUT QT_NO_WARNING_OUTPUT

验证方式 #

编译完成后检查DLL导入表，确认仅依赖发行版CRT、发行版Qt相关动态库，不存在msvcrtd.dll、QtCored.dll这类调试版库依赖，即可同时给Debug、Release两种配置的用户工程链接使用，用户调试程序时无法单步进入DLL内部，符合预期。

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