AUTOMOC如何确定文件加入mocs_compilation.cpp？如何单独编译相关文件

• AUTOMOC会先扫描目标关联的所有头文件和源文件，识别包含Q_OBJECT、Q_GADGET、Q_NAMESPACE等Qt元对象宏的文件，生成对应的moc_<文件名>.cpp文件
• 生成的moc_*.cpp如果没有被你项目中的任意源文件手动#include引入，就会被自动归入mocs_compilation.cpp作为统一翻译单元的一部分编译
• 被标记了SKIP_AUTOMOC属性的源文件不会参与AUTOMOC扫描，也不会生成对应moc文件进入统一编译单元

你可以根据你的项目版本和需求选择以下任意方案：

• 方案1：手动引入对应moc文件
  对每个包含Qt元对象宏的文件，在对应的.cpp文件末尾添加#include "moc_<当前文件名>.cpp"，CMake检测到该moc文件已经被手动引入后，就不会将其加入mocs_compilation.cpp，会随所属的.cpp文件一同编译。
• 方案2：全局关闭AUTOMOC统一编译特性（CMake 3.17及以上版本支持）
  直接在项目根CMakeLists.txt中添加如下配置：

  # 禁止AUTOMOC将多个moc文件合并为统一翻译单元
  set(CMAKE_AUTOMOC_UNITY_BUILD OFF)
  # 可选：如果存在头文件路径识别问题，额外添加AUTOMOC的头文件搜索目录
  set(CMAKE_AUTOMOC_INCLUDE_DIRECTORIES "${PROJECT_SOURCE_DIR}/你的头文件根目录")
  

  如果仅需要对单个目标生效，可以改为设置目标属性：

  set_target_properties(你的目标名称 PROPERTIES
    AUTOMOC_UNITY_BUILD OFF
  )
  

  配置后每个moc_*.cpp都会作为独立的翻译单元单独编译，不会被合并到mocs_compilation.cpp中。
• 方案3：针对单个文件跳过统一编译
  如果你只需要部分moc文件单独编译，可以给对应源文件设置属性：

  set_source_files_properties(需要单独编译的头文件路径.h PROPERTIES
    SKIP_UNITY_BUILD_INCLUSION ON
  )
  

附加说明 #

你遇到的基类未定义错误是mocs_compilation.cpp作为统一翻译单元的常见问题：合并后的翻译单元头文件引入顺序和独立编译时不一致，部分前置声明、头文件依赖没有按预期生效，切换为单独编译moc文件后即可解决该类问题。

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