Doxygen是否支持Python参数类型提示？1.8.5版本参数文档截断问题求解

1. Doxygen是否支持Python的参数类型提示？ #

Doxygen对Python参数类型提示的支持是逐步完善的：

• 你使用的1.8.5属于早期版本（2013年发布），对PEP 484规范的类型提示（即函数签名里param: type的写法）原生支持非常有限，基本无法直接解析这类语法，只能通过docstring里的@param标签手动补充类型说明；
• 从1.9.0版本开始，Doxygen才添加了对Python类型提示的原生解析支持，能够直接识别函数签名中的类型标注，并自动同步到生成的文档中。

2. 1.8.5版本生成文档时参数被截断的解决办法 #

你遇到的test_point_count参数后文档被截断的问题，本质是1.8.5版本的Python解析器无法识别函数签名里的类型提示语法（:符号），导致解析逻辑出错，中断了后续参数的解析。可以尝试以下配置调整或临时方案：

配置项调整 #

• 开启OPTIMIZE_OUTPUT_JAVA = YES：早期Doxygen处理Python代码时复用了Java的解析逻辑，开启这个选项可能改善对参数列表的解析兼容性；
• 确保PYTHON_DOCSTRING = YES：该配置会让Doxygen优先解析Python的docstring内容，依赖你写的@param标签生成参数文档，一定程度上绕过函数签名的解析问题（1.8.5版本包含此配置项）；
• 检查MAX_PARAMETER_LIST_LENGTH：默认值为200，如果参数列表长度超过阈值会被截断，可尝试将其调大（比如设为500）排除长度问题。

临时 workaround #

由于1.8.5版本的Python兼容性确实较差，最直接的办法是修改函数签名，暂时移除类型提示，或者将类型说明移到docstring的@param标签中，示例如下：

def expect_equal(logger, test_point_count, expected, actual, tolerance=0, desc=""):
    """
    Logging helper comparing 2 values and logging results
    @param logger: Logger used for outputting results
    @param test_point_count: iterator value for tp count (int)
    @param expected: expected value for test (any)
    @param actual: actual result of test (any)
    @param tolerance: float describing the +/- tolerance for check (float, default 0)
    @param desc: str description of test and results (str, default "")
    """

这样Doxygen能正确解析所有参数的文档内容，不会出现截断。

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