【Doxygen】学习笔记|无法生成文件、中文乱码等常见问题

以下内容是自己根据自己的经验总结的，可能有误，欢迎指正！

---

1. 为什么我点了RUN之后，没有说明文件生成？

点了Run Doxygen之后，没有文件生成，并且Show HTML output是灰色的，多半是因为你前面的编码模式没有设置好，如你编码模式是UTF-8，但你的源文件是GB2312。

2. 如何修改输出文件为中文？

这里的中文指的是输出文件页面的语言，并非代码中注释的中文。

设置流程：Expert→OUTPUT_LANGUAGE→chinese

ps：这个设置解决不了注释中的中文显示为乱码。

3. 按照网上的教程设置了编码格式中文还是乱码？

1. INPUT_ENCODING 是源码文件编译模式，这个需要去看自己的.h和.cpp文件是什么编码格式，然后对应的填写。VS2015好像默认是GB2312，不放心的话就打开高级保存选项看一看，然后Doxygen中填GB2312。

2. DOXYFILE_ENCODING是输出文件的编码格式，默认UTF-8应该是没问题的，或者改成GBK。

note：上述流程跟网上其他教程说的差不多，为什么设置完还是乱码，很有可能是不同的源文件是不同的编码形式造成的，可以在INPUT_FILE_ENCODING中把多种编码模式都输入进去，让其自动匹配。

4. 如何为特定的.h文件或.cpp文件生成说明文档？

网上常见的教程里都会提到如下内容：

在Wizard→project中，Source code directory：中，选择源码所在的文件，并且建议选中Scan recursively。

可能大家平时配置VS工程文件的时候，对于小工程，大家一般不会刻意去将.ｈ文件和.cpp文件建文件夹分类管理，所以仅仅是按照上述去选择源码的路径的话，他会将目录里所有的源文件都算进去了。但我们有时候可能仅仅需要生成其中的部分.h文件或者.cpp文件的说明文档。

设置流程：

Expert→Input，在INPUT里，可以直接具体到源文件来添加，如下图所示：