如何修复Doxygen生成PDF文件时代码段格式异常问题？

1. 调整Doxygen配置文件（Doxyfile） #

• 启用LATEX_LISTINGS：将配置项设为YES，让Doxygen使用LaTeX的listings包渲染代码，替代默认的verbatim环境，能更好保留格式和处理换行。
• 设置LATEX_WRAP_LINE_LENGTH：指定代码行的自动换行长度，比如设为80，避免长行被无意义截断。
• 确保LATEX_SOURCE_CODE设为YES，保证源码块被正确转换为LaTeX可识别的格式。

2. 优化代码段标记 #

在mainpage.dox中，替换原有的\code{.cpp}标记为LaTeX原生的listings环境（前提是已启用LATEX_LISTINGS）：

\begin{lstlisting}[language=C++]
// 你的长代码行示例
void exampleFunctionWithLongParameters(int param1, int param2, int param3, std::string longStringParam, std::vector<int> longVectorParam) {
    // 代码逻辑
}
\end{lstlisting}

这种方式比\code标记对LaTeX的支持更友好，能精准控制代码的语法高亮和换行规则。

3. 检查MiKTeX依赖包 #

确保MiKTeX已安装listings包：打开MiKTeX Console，在“Packages”搜索栏输入listings，找到后安装。缺失该包会导致Doxygen无法正确渲染代码块，出现格式混乱。

4. 调整PDF生成的换行策略 #

如果长代码行仍有错误换行，可在Doxygen配置中添加LATEX_EXTRA_PACKAGES，指定listings的额外参数：

LATEX_EXTRA_PACKAGES = listings[breaklines=true,breakatwhitespace=true]

这个配置让listings仅在空格处换行，避免截断代码标识符。

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