如何在Doxygen中实现图片并排显示？

我之前也碰到过这个困扰！Doxygen默认会把图片垂直堆叠，但其实可以通过嵌入HTML代码来实现并排显示，下面是几个实测有效的方案：

方案1：使用Flex布局（推荐，现代且灵活） #

利用HTML的Flex容器来让图片并排，还能自动处理响应式换行，适合大多数场景。在你的主页面文件（比如mainpage.md或者带@mainpage指令的文件）中添加以下代码：

@mainpage 你的项目名称

@htmlonly
<div style="display: flex; gap: 15px; flex-wrap: wrap;">
  <img src="first_image.png" alt="第一张图片说明" style="width: 45%; height: auto;">
  <img src="second_image.png" alt="第二张图片说明" style="width: 45%; height: auto;">
</div>
@endhtmlonly

• display: flex：把容器变成弹性布局，内部元素自动并排
• gap: 15px：设置图片之间的间距，避免挤在一起
• flex-wrap: wrap：当屏幕宽度不够时，图片会自动换行，保证移动端显示正常
• width: 45%：让每张图片占容器宽度的45%，剩下的空间用作间隙；也可以换成固定宽度（比如300px）

方案2：使用HTML表格（兼容性强） #

如果你的Doxygen版本比较老，或者更习惯用表格布局，这种方法兼容性更好：

@mainpage 你的项目名称

@htmlonly
<table style="border-collapse: separate; border-spacing: 15px;">
  <tr>
    <td style="padding: 0;"><img src="first_image.png" alt="第一张图片说明" style="width: 100%;"></td>
    <td style="padding: 0;"><img src="second_image.png" alt="第二张图片说明" style="width: 100%;"></td>
  </tr>
</table>
@endhtmlonly

• border-spacing: 15px：设置单元格之间的间距
• 图片的width: 100%会让图片填满单元格宽度，两张图自然并排

注意事项 #

• 确保图片路径正确：可以把图片放在Doxygen配置文件Doxyfile中IMAGE_PATH指定的目录，或者使用相对于主页面文件的相对路径
• 如果你的主页面用的是Markdown格式，部分新版本Doxygen允许直接写HTML代码，无需包裹@htmlonly和@endhtmlonly，但加上更稳妥，避免语法冲突

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