Doxygen生成PDF文档时函数参数表格列宽异常问题解决方案问询

方案1：调整Doxyfile核心配置 #

• 将Doxyfile中的COMPACT_LATEX配置项从YES修改为NO：

  COMPACT_LATEX = NO
  

  紧凑LaTeX模式会强制使用固定窄列宽的表格格式，是导致参数说明表列宽错位、文字溢出的最常见原因，关闭后默认会使用自适应宽度的表格布局。

方案2：添加自定义LaTeX样式表修复表格逻辑 #

1. 新建名为custom_latex.sty的样式文件，写入以下内容：

\usepackage{tabularx}
% 重写Doxygen参数表格环境，适配页面宽度
\renewenvironment{DoxyParams}[1]{%
  \par\vspace{0.2cm}
  \begin{tabularx}{\linewidth}{@{}l>{\raggedright\arraybackslash}X@{}}
    \hline
    \multicolumn{2}{l}{\textbf{#1}} \\
    \hline
}{%
  \hline
  \end{tabularx}
  \par\vspace{0.2cm}
}

2. 修改Doxyfile中的LATEX_EXTRA_STYLESHEET配置，指向新建的样式文件：

LATEX_EXTRA_STYLESHEET = ./custom_latex.sty

该方案会强制参数说明表使用自适应页面宽度的布局，参数名列固定宽度，参数描述列自动占满剩余可用宽度，从根本上解决列宽计算异常问题。

方案3：修复自定义header.tex的样式缺失 #

你当前仅修改了标题页逻辑，若自定义的header.tex是完全替换了Doxygen默认的LaTeX头文件，可能缺失了表格相关的基础样式导入：

• 先执行命令导出Doxygen默认LaTeX模板：

  doxygen -w latex default_header.tex default_footer.tex default_sty.sty
  

• 基于导出的default_header.tex修改标题页内容，不要完全自定义header.tex，避免缺失必要的样式定义。

方案4：升级Doxygen版本 #

低于1.9.0版本的Doxygen本身存在LaTeX表格列宽计算的已知bug，升级到最新稳定版即可直接修复这类问题。

内容的提问来源于stack exchange，提问作者A.M.