Sphinx+Breathe的doxygenfunction仅支持带声明的函数？求助

核心结论 #

doxygenfunction 确实仅对Doxygen已索引的函数符号生效，而Doxygen默认只会提取头文件中声明的函数（除非调整配置）。你的问题根源就在这里：

• main() 只有.c文件里的定义，没有头文件声明，默认配置下Doxygen不会把它加入符号索引，所以Breathe找不到；
• subtract() 原本有头文件声明，能被Doxygen索引，注释后失去声明，自然也无法被识别；
• doxygenfile::main.c 是直接嵌入整个文件内容，不依赖符号索引，所以不受影响。

修复步骤 #

要让doxygenfunction能识别main()这类只有定义的函数，需要调整Doxygen配置：

1. 修改Doxyfile，让Doxygen解析源文件：
   找到INPUT配置项，把你的源文件目录（比如src）加入进去，示例：

   INPUT = include src
   

2. 强制Doxygen提取所有符号：
   找到EXTRACT_ALL配置项，设置为YES，这样Doxygen会提取所有可见的函数（包括只有定义没有头声明的）：

   EXTRACT_ALL = YES
   

3. 重新执行生成命令：

   doxygen Doxyfile; make -C docs html
   

补充说明 #

如果不想全局开启EXTRACT_ALL，也可以针对单个函数添加Doxygen注释标记（比如在main()定义上方加/** @file */或者/** @brief 主函数 */），同时开启EXTRACT_PRIVATE = YES，但EXTRACT_ALL对新手项目来说是最直接的解决方案。

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