Windows下导出DLL所有符号含Qt元对象（Qt6.5+CMake）

问题根源 #

WINDOWS_EXPORT_ALL_SYMBOLS 仅扫描你编写的源文件符号，但Qt元对象系统依赖MOC生成的代码（如staticMetaObject、qt_metacast等符号），这些生成的代码默认不会被该CMake属性识别，导致元对象符号未导出，引发链接错误。

可行解决方案 #

方案一：结合WINDOWS_EXPORT_ALL_SYMBOLS与Qt内置宏 #

这是最简便的方法，通过Qt内置宏让MOC自动标记元对象符号为可导出：

add_library(your_dll SHARED)
target_sources(your_dll PRIVATE
    your_class.cpp
    your_class.h
)

# 启用CMake自动导出所有符号
set_target_properties(your_dll PROPERTIES WINDOWS_EXPORT_ALL_SYMBOLS ON)

# 让MOC生成的元对象符号自动带上导出标记
target_compile_definitions(your_dll PRIVATE QT_QML_EXPORT_ALL)

# 确保Qt自动处理MOC
set_target_properties(your_dll PROPERTIES AUTOMOC ON)

说明：QT_QML_EXPORT_ALL 宏会让MOC在生成元对象代码时，自动为staticMetaObject等核心符号添加Q_DECL_EXPORT标记，使其被WINDOWS_EXPORT_ALL_SYMBOLS或编译器识别为导出符号。

方案二：手动补充.def文件 #

如果方案一未生效，可手动生成.def文件指定元对象符号，强制导出：

1. 创建your_dll.def文件，添加需要导出的元对象符号（符号名可通过dumpbin /symbols your_class.obj查看）：

EXPORTS
    ?staticMetaObject@YourClass@@2VQMetaObject@@B
    ?qt_metacast@YourClass@@QEAAPEAXPEBD@Z
    ?qt_static_metacall@YourClass@@CAXPEAVQObject@@W4QMetaObjectCall@@PEAPEAXXZ

2. 在CMake中关联该.def文件：

add_library(your_dll SHARED)
target_sources(your_dll PRIVATE
    your_class.cpp
    your_class.h
    your_dll.def
)
set_target_properties(your_dll PROPERTIES WINDOWS_EXPORT_ALL_SYMBOLS ON)

方案三：自定义MOC导出宏 #

通过自定义编译定义，强制MOC为元对象符号添加导出标记：

add_library(your_dll SHARED)
target_sources(your_dll PRIVATE
    your_class.cpp
    your_class.h
)

set_target_properties(your_dll PROPERTIES
    AUTOMOC ON
    WINDOWS_EXPORT_ALL_SYMBOLS ON
)

# 让MOC生成的代码使用Q_DECL_EXPORT标记元对象符号
target_compile_definitions(your_dll PRIVATE "QT_MOC_EXPORT=Q_DECL_EXPORT")

验证方法 #

编译完成后，使用dumpbin /exports your_dll.dll命令查看导出符号列表，确认staticMetaObject、qt_metacast等元对象相关符号存在即可。

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