如何以“验证模式”运行Doxygen？仅验证文档不生成输出

我想让Doxygen以“验证模式”运行——也就是解析所有文档，按配置输出警告，但不生成任何输出文件。我尝试了下面的Doxygen配置文件：

DOXYFILE_ENCODING = UTF-8
QUIET = YES
INHERIT_DOCS = YES
EXTRACT_STATIC = YES
EXTRACT_PRIVATE = NO
WARN_NO_PARAMDOC = YES
WARN_IF_UNDOCUMENTED = YES
WARN_IF_DOC_ERROR = YES
WARN_FORMAT = $file($line): $text
GENERATE_HTML = NO
GENERATE_LATEX = NO
INPUT += MySource.cs

源文件片段：

/// <summary>
/// ...的内容

其实你已经走对方向啦！要实现只验证文档、不生成输出文件的“验证模式”，只需要在现有配置基础上补充几个关键设置，就能完全达到目的：

关键配置调整 #

• 禁用所有输出生成器：你已经关闭了HTML和LaTeX，但Doxygen默认还会开启XML、MAN等其他输出格式，必须把这些也全部禁用，确保不会生成任何输出文件：

  GENERATE_XML = NO
  GENERATE_MAN = NO
  GENERATE_RTF = NO
  GENERATE_DOCBOOK = NO
  GENERATE_AUTOGEN_DEF = NO
  GENERATE_PERLMOD = NO
  

• 强化警告检查（可选）：如果需要更严格的验证，可以开启WARN_AS_ERROR = YES，这样Doxygen会把所有警告当作错误处理，一旦检测到问题就终止运行，非常适合持续集成（CI）环境下的自动检查：

  WARN_AS_ERROR = YES
  

• 保留必要的解析配置：你当前设置的EXTRACT_STATIC、INHERIT_DOCS等选项很合理，它们能让Doxygen正确解析代码的结构和继承关系，保证警告信息的准确性。如果你的项目还有其他源文件（比如头文件），记得把它们的路径补充到INPUT中。

完整配置示例 #

把上述调整整合后，最终的配置文件大概是这样：

DOXYFILE_ENCODING = UTF-8
QUIET = YES
INHERIT_DOCS = YES
EXTRACT_STATIC = YES
EXTRACT_PRIVATE = NO
WARN_NO_PARAMDOC = YES
WARN_IF_UNDOCUMENTED = YES
WARN_IF_DOC_ERROR = YES
WARN_FORMAT = $file($line): $text
# 禁用所有输出生成器
GENERATE_HTML = NO
GENERATE_LATEX = NO
GENERATE_XML = NO
GENERATE_MAN = NO
GENERATE_RTF = NO
GENERATE_DOCBOOK = NO
GENERATE_AUTOGEN_DEF = NO
GENERATE_PERLMOD = NO
# 可选：将警告视为错误
WARN_AS_ERROR = YES
INPUT += MySource.cs

运行方式 #

直接用以下命令运行Doxygen即可：

doxygen your_config_file_name

这样Doxygen就会完整解析你的代码文档，输出所有符合配置的警告信息，同时不会生成任何输出文件。

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