C# 9.0环境下Doxygen 1.8.17解析二维数组代码异常的解决咨询

这类解析异常和你代码的写法优雅度无关，本质是Doxygen 1.8.17版本内置C#解析器的已知硬伤：

• 解析器碰到二维数组索引内的逗号时，会误将其判定为多方法参数的分隔符，直接截断当前语句的语法解析
• 解析器未正确重置上一行语句的类型缓存，会逐行累加残留的double类型标识，最终生成你看到的重复类型前缀的截断输出
• 该bug的触发条件和C# 9.0的表达式-bodied属性（也就是=>语法）强相关，1.9.2之后版本的Doxygen已经修复了该类C#语法解析问题

不需要修改项目代码，调整Doxyfile配置即可覆盖大部分解析异常：

• 开启预处理阶段的语法隔离：依次将ENABLE_PREPROCESSING设为YES、MACRO_EXPANSION设为YES、EXPAND_ONLY_PREDEF设为YES，让预处理器先完成语法替换，避免原始数组索引里的逗号直接暴露给存在bug的核心解析器
• 在PREPROCESSOR_DEFINITIONS中新增占位宏规则，在预处理阶段将二维数组索引结构做临时语法替换，让核心解析器识别不到数组内的逗号，示例规则：#define TwoDIdx(arr,r,c) [r;c]
• 关闭无意义的语法校验提示：将WARN_NO_PARAMDOC设为NO，避免解析器对截断的语句抛出无意义的报错干扰文档生成流程

如果调整配置后仍存在解析错误，可通过极低代价的代码调整彻底规避bug，完全不影响业务运行逻辑：

• 将触发bug的表达式-bodied属性，替换为带显式get方法的传统属性写法，示例：

// 原触发bug的写法
public double V00 => values[0, 0];
// Doxygen可正常识别的等价写法
public double V00 { get { return values[0, 0]; } }

这种写法不会在语句中直接暴露二维数组的索引逗号，可完全绕开解析器的截断逻辑。

• 通过条件编译隔离Doxygen的解析路径：在项目中新增DOXYGEN条件编译符号，当Doxygen扫描代码时，使用无数组索引的极简属性定义供解析器识别，实际编译运行时仍使用原来的二维数组访问逻辑，示例：

#if DOXYGEN
public double V00 { get; }
public double V01 { get; }
#else
public double V00 => values[0, 0];
public double V01 => values[0, 1];
#endif

该方案的好处是既可以让Doxygen生成完整的属性文档，又完全不改动生产环境的代码逻辑。

注：如果可以调整工具版本，直接将Doxygen升级到1.9.2及以上版本，可原生支持C# 9的表达式属性、二维数组索引语法，无需做任何配置或代码调整即可从根源解决该问题。

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