Doxygen无法正确剥离代码片段注释的问题求助

方案1：启用Clang辅助解析 #

• 启用CLANG_ASSISTED_PARSING能让Doxygen更精准识别并处理C风格横幅注释，配合STRIP_CODE_COMMENTS=YES即可移除纯符号注释，且不会暴露私有注释或插入多余换行。
• 在Doxyfile中添加配置：

  CLANG_ASSISTED_PARSING = YES
  

• 注意：需要环境中安装与Doxygen v10.0兼容的Clang编译器，确保解析正常运行。

方案2：自定义脚本过滤注释 #

• 写个简单脚本预处理代码，过滤掉纯符号组成的横幅注释，再让Doxygen调用这个脚本。
• 示例Python脚本（命名为strip_banners.py）：

  import sys
  import re
  
  def strip_banners(line):
      # 匹配/*********/、/*---------*/这类纯符号横幅注释
      pattern = r'^\s*/\*[*\-_]+/\s*$'
      if re.match(pattern, line):
          return ''
      return line
  
  for line in sys.stdin:
      print(strip_banners(line), end='')
  

• 在Doxyfile中配置过滤规则：

  FILTER_PATTERNS = *.cpp="python3 strip_banners.py"
  

• 这种方式能严格保留原有代码结构，不会产生多余换行，也不会泄露未用/** */标记的私有注释。

方案3：调整注释解析基础配置 #

• 检查Doxyfile中的COMMENT_SYMBOLS，确保没有自定义干扰注释识别的符号，保持默认值即可：

  COMMENT_SYMBOLS = 
  

• 同时确认ENABLED_SECTIONS未包含影响注释处理的特殊段，避免干扰STRIP_CODE_COMMENTS的正常工作。

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