大型Qt项目CMake中AUTOMOC优化：避免生成空moc_*文件

针对你遇到的通配源文件+AUTOMOC导致大量空moc文件生成的问题，这里有几个实用的优化方案，按复杂度从低到高排序：

1. 使用MOC的无关键字不输出选项（推荐） #

Qt 5.15及以上版本的MOC提供了--no-output-if-no-keywords选项，当处理的文件中不包含Q_OBJECT、Q_GADGET、Q_NAMESPACE等元对象宏时，不会生成空的moc输出文件。

只需在CMake配置中添加该选项即可，全局生效：

set(CMAKE_AUTOMOC_MOC_OPTIONS "--no-output-if-no-keywords")

或者针对单个目标生效：

set_target_properties(YourTargetName PROPERTIES AUTOMOC_MOC_OPTIONS "--no-output-if-no-keywords")

这个方案无需修改现有通配逻辑，也不会触发额外的CMake重新配置，完全在构建阶段处理，能直接避免空moc文件的生成、编译和链接开销。

2. 配置阶段筛选需MOC处理的文件 #

如果你的Qt版本低于5.15，无法使用上述选项，可以在CMake配置阶段手动筛选出包含元对象宏的文件，仅对这些文件执行MOC处理：

步骤1：定义检查宏的函数 #

function(has_qt_meta_macro FILE_PATH OUTPUT_VAR)
    file(READ "${FILE_PATH}" FILE_CONTENTS)
    # 检查常见的Qt元对象宏
    string(FIND "${FILE_CONTENTS}" "Q_OBJECT" FOUND_Q_OBJECT)
    string(FIND "${FILE_CONTENTS}" "Q_GADGET" FOUND_Q_GADGET)
    string(FIND "${FILE_CONTENTS}" "Q_NAMESPACE" FOUND_Q_NAMESPACE)
    
    if(NOT (FOUND_Q_OBJECT EQUAL -1 OR FOUND_Q_GADGET EQUAL -1 OR FOUND_Q_NAMESPACE EQUAL -1))
        set(${OUTPUT_VAR} TRUE PARENT_SCOPE)
    else()
        set(${OUTPUT_VAR} FALSE PARENT_SCOPE)
    endif()
endfunction()

步骤2：筛选文件并手动生成MOC代码 #

# 原有通配逻辑不变
file(GLOB_RECURSE ALL_SOURCES "src/*.cpp" "src/*.h")

# 筛选需要MOC的文件
set(MOC_CANDIDATES "")
foreach(FILE IN LISTS ALL_SOURCES)
    has_qt_meta_macro("${FILE}" NEEDS_MOC)
    if(NEEDS_MOC)
        list(APPEND MOC_CANDIDATES "${FILE}")
    endif()
endforeach()

# 手动调用qt_wrap_cpp生成MOC文件
qt_wrap_cpp(MOC_GENERATED_SOURCES ${MOC_CANDIDATES})

# 添加目标时包含所有源文件和生成的MOC文件，并关闭自动AUTOMOC
add_library(YourTargetName ${ALL_SOURCES} ${MOC_GENERATED_SOURCES})
set_target_properties(YourTargetName PROPERTIES AUTOMOC OFF)

注意：这个方案会在CMake配置阶段读取文件内容，如果文件内容变更（比如添加/移除Q_OBJECT宏），会触发CMake重新配置。但如果只是Qt头文件变更，不会触发重新配置，因为我们没有依赖这些头文件的内容。

3. 不推荐：修改Ninja构建规则 #

直接修改CMake生成的build.ninja文件不可行，因为每次CMake重新配置都会覆盖该文件。如果要通过Ninja层面优化，需要编写自定义CMake模块来动态修改生成的Ninja规则，但维护成本极高，容易因CMake版本或Qt版本变更而失效，因此不推荐。

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