Doxygen未从INCLUDE_PATH收集文件，Mock CPP文档配置咨询

• 检查INPUT配置，添加Mock文件目录
  Doxygen仅扫描INPUT参数指定路径下的文件，需将Mock CPP所在的独立目录加入配置：

  INPUT = /path/to/original_src /path/to/mock_src
  

• 确认FILE_PATTERNS包含CPP后缀
  确保配置中FILE_PATTERNS未遗漏*.cpp（或你的Mock文件后缀），示例：

  FILE_PATTERNS = *.cpp *.hpp *.h
  

• 给Mock文件添加@file标签明确标识
  在Mock CPP文件开头添加@file标签，帮助Doxygen识别文件归属，同时配合@ingroup使用：

  /**
   * @file mock_target.cpp
   * @ingroup target_module
   * 单元测试用Mock实现的文档说明
   */
  

• 排查原文件与Mock文件的冲突
  若原CPP与Mock CPP对应同一头文件，Doxygen可能优先处理原文件。可通过EXCLUDE参数临时排除原文件，或调整扫描顺序让Mock文件优先被处理：

  EXCLUDE = /path/to/original_src/target.cpp
  

• 验证@ingroup的组定义有效性
  确保Mock文件中@ingroup/@addtogroup对应的组已在原头文件或其他已收录文件中通过@defgroup定义，无有效组归属可能导致文档被忽略。

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