LaTeX子图排版全攻略：从subcaption宏包到多图网格布局实践

1. 项目概述为什么LaTeX子图是科研与写作的“刚需”如果你写过论文、技术报告或者任何需要插入多张对比图片的文档大概率遇到过这样的烦恼在Word里费劲地拖动、对齐几张图片好不容易摆整齐了一更新文字图片位置又全乱了。或者你想给一组相关的图片加上统一的a、b、c编号并共用一个总标题在常规的图文混排工具里这往往意味着繁琐的手动操作。这正是“LaTeX生成子图及并列图”这个主题要解决的核心痛点。它不是一个炫技的功能而是LaTeX排版系统在处理复杂图文关系时体现其“内容与格式分离”哲学的一个经典案例。简单来说LaTeX中的子图Subfigure或更现代的并列图Subfig功能允许你将多个独立的图片figure逻辑上组合成一个“父图”parent figure。这个父图在文档中作为一个整体单元被引用、编号和定位。而其内部的每一张小图则可以拥有自己的子标题subcaption并且可以按照你的需求进行灵活排列比如并排两列、三列甚至更复杂的网格布局。对于学术写作、实验数据对比、多角度展示等场景这几乎是不可或缺的。我见过太多研究生和工程师因为不熟悉这个功能要么提交的论文图表杂乱无章要么在调整格式上浪费了大量本该用于思考内容的时间。掌握LaTeX子图意味着你获得了对图表排版精准、稳定的控制力。一旦定义好无论文档其他部分如何增删修改这一组图片的相对位置、编号关联都会由LaTeX引擎自动维护绝不会错乱。这对于需要反复修改的稿件、以及必须严格遵守格式要求的学位论文或期刊投稿来说价值巨大。接下来我将从一个实践者的角度拆解从环境配置、宏包选型到具体语法、高级技巧的全流程让你不仅能“做出”子图更能理解其背后的设计逻辑从而应对各种复杂场景。2. 核心思路与宏包选型subcaption为何成为现代首选在LaTeX中实现子图历史上出现过多个宏包如古老的subfigure、后来流行的subfig以及现在被广泛推荐为最佳实践的subcaption。为什么社区共识逐渐转向了subcaption这背后是LaTeX开发理念的演进更强的兼容性、更清晰的接口和与核心宏包如caption的无缝协作。subfigure宏包年代久远其语法和功能已显陈旧与现代的hyperref超链接、cleveref智能引用等宏包配合时容易产生冲突和警告。subfig宏包是一个重要的改进它提供了\subfloat命令在一段时间内是主流选择。然而subcaption宏包可以看作是subfig的“现代化继承者”。它由caption宏包的作者维护因此与caption宏包用于自定义标题样式天生兼容提供了高度一致的API。它的最大优势在于每个子图在内部被真正当作一个独立的minipage环境或类似结构来处理这使得对其应用边框、背景色、独立旋转等操作变得非常直观。此外它在处理交叉引用和生成列表List of Figures时更为稳健。因此在当前2023年及以后的LaTeX项目中我的明确建议是优先使用subcaption宏包。除非你正在维护一个十几年前的古老文档模板且无法修改否则新项目都应基于subcaption构建。它的语法清晰学习曲线平缓并且是未来维护的保障。注意一些期刊或学校的论文模板可能仍在使用subfig。在投稿前务必检查模板说明或.cls/.sty文件。如果模板强制使用了subfig则应遵循模板要求避免宏包冲突。但在个人或团队内部项目中坚持使用subcaption是更优的选择。确定了核心宏包一个典型的子图文档 preamble导言区通常如下所示\documentclass{article} % 或 report, book 等 \usepackage{graphicx} % 必须用于插入图片 \usepackage{subcaption} % 核心用于创建子图 \usepackage{caption} % 推荐用于统一标题样式subcaption会自动加载它但显式声明是个好习惯 % 可选但常用的宏包 \usepackage{float} % 提供 [H] 等更严格的浮动体控制 \usepackage{hyperref} % 为引用添加超链接 \usepackage{cleveref} % 智能交叉引用能自动识别figure、table等类型 \begin{document} % 文档内容... \end{document}这个配置构成了我们工作的基础。graphicx和subcaption是铁打的核心。float和hyperref、cleveref则能极大提升体验尤其是在撰写长篇文档时。3. 基础语法与单行并列图实战我们先从最常见的场景开始将两到三张图片并排放在一行共享一个总标题并各有子标题。这是展示对比实验、不同视角、前后状态最直观的方式。3.1 两图并列的标准写法假设我们有两张图片result_a.png和result_b.png我们希望它们并排总标题为“模型性能对比”子标题分别为“(a) 训练损失”和“(b) 验证准确率”。\begin{figure}[htbp] % htbp 是常用的浮动位置参数 \centering % 让整个figure环境居中 \begin{subfigure}[b]{0.48\textwidth} % [b] 表示子图底部对齐宽度为文本宽度的48% \centering \includegraphics[width\linewidth]{result_a.png} % \linewidth 会继承subfigure的宽度 \caption{训练损失} % 子标题 \label{fig:sub_a} % 子图的标签用于引用 \end{subfigure} \hfill % 一个弹性填充将两个子图推到两端中间产生均匀间距 \begin{subfigure}[b]{0.48\textwidth} \centering \includegraphics[width\linewidth]{result_b.png} \caption{验证准确率} \label{fig:sub_b} \end{subfigure} \caption{模型性能对比} % 总标题 \label{fig:performance} % 总图的标签 \end{figure}关键参数与技巧解析\begin{subfigure}[b]{0.48\textwidth}[b]对齐参数。可以是t顶部对齐、b底部对齐、c居中默认。当子图高度不一致时这个参数决定了它们以哪条边为基准对齐。对于大多数包含坐标轴的图表使用[b]底部对齐视觉效果最好能保证横坐标对齐。{0.48\textwidth}指定该子图环境的宽度。这里设为文本宽度的48%而非50%是为了在两个子图之间留出一些空隙Gap。使用\hfill可以灵活地控制这个空隙。\includegraphics[width\linewidth]{...}这里的\linewidth是一个智能的长度变量它等于当前环境即subfigure的宽度。这样设置可以确保图片完美填满你为子图分配的宽度无需手动计算像素或比例。\hfill这是一个“弹性空白”命令。它会尽可能地将它两侧的内容推开。在这里它被放在两个subfigure环境之间使得两个子图一个靠左、一个靠右中间的空间被均匀填充从而实现了美观的等间距并列。这比使用固定的\hspace{1cm}更灵活能自动适应不同的页面布局。标签\label与引用我们为每个子图fig:sub_a,fig:sub_b和总图fig:performance都打了标签。在文中引用时引用总图如图\ref{fig:performance}所示会显示为“如图1所示”。引用子图图\ref{fig:performance}(\ref{fig:sub_a})或图\ref{fig:sub_a}。更优雅的方式是配合cleveref宏包\cref{fig:sub_a}它会自动生成“图1a”这样的格式非常方便。3.2 三图并列的布局策略三图并列的原理相同但宽度分配需要更精细。如果每张图都设为0.32\textwidth三个\hfill可能无法达到完美等间距。一个更稳健的写法是使用\hfill分隔并适当调整宽度比例。\begin{figure}[htbp] \centering \begin{subfigure}[b]{0.31\textwidth} \centering \includegraphics[width\linewidth]{view1.jpg} \caption{前视图} \label{fig:view1} \end{subfigure} \hfill \begin{subfigure}[b]{0.31\textwidth} \centering \includegraphics[width\linewidth]{view2.jpg} \caption{侧视图} \label{fig:view2} \end{subfigure} \hfill % 第二个\hfill确保三个图之间的空隙均匀 \begin{subfigure}[b]{0.31\textwidth} \centering \includegraphics[width\linewidth]{view3.jpg} \caption{俯视图} \label{fig:view3} \end{subfigure} \caption{物体三视图展示} \label{fig:three_views} \end{figure}这里每个子图宽度设为31%总共93%留下了约7%的宽度作为两个\hfill的填充空间。这是一种经验值你可以根据图片的宽高比和实际显示效果微调例如尝试0.30\textwidth。实操心得当并列图片超过3张时单行布局会使得每张图过于狭窄影响阅读。此时应考虑转为多行布局即下面要讲的网格排列。4. 高级布局网格排列、混合内容与自定义样式实际需求往往比简单的单行排列更复杂。你可能需要2x2的网格也可能需要在子图里放的不是图片而是表格、公式或其他内容。4.1 实现2x2网格排列网格排列的本质是嵌套使用subfigure环境并合理使用\hfill和换行符\\。目标是创建两行每行两个子图。\begin{figure}[htbp] \centering % 第一行 \begin{subfigure}[b]{0.48\textwidth} \centering \includegraphics[width0.9\linewidth]{data_flow_step1.pdf} % 使用0.9\linewidth让图片在子图框内有些边距 \caption{数据输入} \label{fig:grid_a1} \end{subfigure} \hfill \begin{subfigure}[b]{0.48\textwidth} \centering \includegraphics[width0.9\linewidth]{data_flow_step2.pdf} \caption{预处理} \label{fig:grid_a2} \end{subfigure} \\[4pt] % 换行并增加一点垂直间距4pt比单纯的\\更好看 % 第二行 \begin{subfigure}[t]{0.48\textwidth} % 这里第二行改用[t]顶部对齐通常与第一行的[b]配合取决于图片内容 \centering \includegraphics[width0.9\linewidth]{data_flow_step3.pdf} \caption{模型计算} \label{fig:grid_b1} \end{subfigure} \hfill \begin{subfigure}[t]{0.48\textwidth} \centering \includegraphics[width0.9\linewidth]{data_flow_step4.pdf} \caption{结果输出} \label{fig:grid_b2} \end{subfigure} \caption{系统数据处理流程的四个核心阶段} \label{fig:data_flow_grid} \end{figure}关键点换行与间距使用\\[4pt]进行换行[4pt]增加了行间距使布局更清晰。你可以调整这个值如\\[6pt]。对齐参数注意我故意将第一行子图设为[b]底部对齐第二行设为[t]顶部对齐。这通常用于当两行图片内容高度差异较大但你希望行内的图片在水平方向上“重心”对齐时。如果所有子图高度接近统一使用[c]居中或[b]即可。图片宽度这里用了width0.9\linewidth让图片在子图框内有一些内边距避免显得过于拥挤视觉效果更舒适。4.2 在子图中混合插入表格与公式subfigure环境本质上是一个容器它可以容纳任何LaTeX内容而不仅仅是\includegraphics。这打开了巨大的灵活性。示例在子图中放置表格\begin{figure}[htbp] \centering \begin{subfigure}[b]{0.45\textwidth} \centering \includegraphics[width\linewidth]{performance_chart.pdf} \caption{算法A与B的性能对比曲线} \label{fig:mix_chart} \end{subfigure} \hfill \begin{subfigure}[b]{0.45\textwidth} \centering \begin{tabular}{lcc} \hline \textbf{指标} \textbf{算法A} \textbf{算法B} \\ \hline 准确率 (\%) 95.2 **96.8** \\ 召回率 (\%) **93.5** 92.1 \\ F1分数 94.3 **94.5** \\ \hline \end{tabular} \caption{详细数值对比} \label{fig:mix_table} \end{subfigure} \caption{实验结果的图形与表格综合展示} \label{fig:mixed_results} \end{figure}示例在子图中放置数学公式或文本描述\begin{subfigure}[c]{0.3\textwidth} \centering \fbox{\parbox{0.9\linewidth}{\centering % 用\fbox加个框用parbox控制文本宽度 核心公式 \[ E mc^2 \] 此公式描述了质量与能量的等价关系。 }} \caption{质能方程} \label{fig:sub_eq} \end{subfigure}这种混合布局能力让你能够在一张“图”里有机地结合视觉展示和数据分析极大提升了信息传达的效率。4.3 自定义子图标题样式与列表格式默认情况下子标题的编号格式是“小写字母”如 (a), (b), (c)。总标题的编号是“数字”如 Figure 1。有时你可能需要改变这些样式比如将子标题改为 (1), (2), (3) 或 A, B, C。这需要通过caption和subcaption宏包提供的命令进行设置通常在导言区完成。\usepackage{caption} \usepackage{subcaption} % 设置总标题的标签格式为“图1.”并设置字体 \captionsetup[figure]{labelformatsimple, labelsepperiod, fontsmall} % 设置子标题的标签格式为“一”、“二” \captionsetup[subfigure]{labelformatsimple, labelsepspace, fontfootnotesize} \renewcommand{\thesubfigure}{\chinese{subfigure}} % 将编号改为中文数字需要ctex宏包或\usepackage{CJK}更常见的需求是修改子图编号的计数器样式。例如使用阿拉伯数字而不是字母\renewcommand{\thesubfigure}{\arabic{subfigure}} % 子图编号显示为 1, 2, 3... % 或者如果你希望编号是 1a, 1b 而不是 (a), (b) % \captionsetup[subfigure]{labelformatbrace, labelsepspace} % \renewcommand{\thesubfigure}{\thefigure\alph{subfigure}} % 不推荐容易混淆另一个高级功能是生成“子图列表”。类似于目录和图表目录你可以生成一个所有子图的列表。% 在文档中需要显示子图列表的地方如目录之后 \listofsubfigures % 需要 subcaption 宏包支持这个命令会生成一个名为“List of Subfigures”的章节列出所有子图的页码和标题。这在长篇报告或学位论文中有时会用到。5. 常见问题、调试技巧与性能优化即使语法正确在实际操作中你仍会遇到各种布局“诡异”的问题。这里记录了我踩过的一些坑和解决方案。5.1 浮动体位置失控与[H]强制定位LaTeX的figure环境是一个“浮动体”float它的位置由LaTeX的排版算法决定参数[htbp]只是偏好建议。有时算法会把图表推到很远的位置如下一章破坏阅读连贯性。解决方案1使用float宏包的[H]选项。\usepackage{float} ... \begin{figure}[H] % 使用大写 H表示“就放在这里绝对不要浮动” \centering ... % 子图内容 \caption{...} \end{figure}[H]会强制将图表放置在代码编写的位置。但需谨慎使用因为它可能造成当前页留下大片空白破坏整体排版美观。通常只用于对位置有严格要求的少数关键图表。解决方案2使用\clearpage或afterpage宏包。如果一组图表很重要你希望它们出现在某个段落之后并且保持连续可以在段落结束后插入\clearpage命令强制LaTeX输出所有未处理的浮动体包括你的图表然后从新的一页开始后续内容。更精细的控制可以使用afterpage宏包。解决方案3调整浮动体参数。在导言区调整LaTeX对浮动体的“宽容度”\setcounter{topnumber}{2} % 页面顶部最多允许的浮动体数量 \setcounter{bottomnumber}{2} % 页面底部最多允许的浮动体数量 \renewcommand{\topfraction}{0.85} % 页面顶部可用于浮动体的最大比例 \renewcommand{\bottomfraction}{0.85} \renewcommand{\textfraction}{0.15} % 页面中必须保留给文本的最小比例 \renewcommand{\floatpagefraction}{0.66} % 浮动页中浮动体必须占据的最小比例这些参数告诉LaTeX“多放一些浮动体在每页的顶部和底部”。这通常能改善浮动体的聚集情况。5.2 子图间距与对齐的微调水平间距如前所述主要靠\hfill。如果想固定间距可以用\hspace{长度}替代\hfill例如\hspace{0.5cm}。垂直间距行间用\\[长度]如\\[6pt]。如果想调整整个figure环境与上下文的间距可以在\begin{figure}后使用\vspace{-10pt}向上移动或\vspace{10pt}向下移动。对齐不齐如果并排的子图底部对不齐检查\includegraphics中的图片是否本身有白边。可以用图像处理软件裁剪或在LaTeX中使用trim和clip参数\includegraphics[trimleft bottom right top, clip, width\linewidth]{...}。更常见的原因是子图内容高度不同确保\begin{subfigure}后的对齐参数[t],[b],[c]设置正确。5.3 引用混乱与cleveref宏包的最佳实践手动写图\ref{fig:xx}(\ref{fig:sub_yy})很容易出错。强烈推荐使用cleveref宏包。\usepackage[capitalise, nameinlink]{cleveref} % capitalise: 引用时“Figure”首字母大写nameinlink: 在超链接中包含名字 ... 在文中引用如\cref{fig:performance}所示其细节\cref{fig:sub_a}表明... 交叉引用对比\cref{fig:sub_a,fig:sub_b}可以发现...cleveref会自动判断引用类型figure, table, equation等并生成正确的格式“图1”、“图1a”、“图1和图2”。它极大地减少了引用错误是撰写学术文档的利器。5.4 超大型子图网格与编译性能当你需要创建3x3甚至更大的子图网格时可能会遇到编译速度变慢的问题尤其是图片都是高分辨率PDF或PNG时。优化建议预编译图片对于矢量图如.pdf,.eps确保它们不是过于复杂。对于由Matlab、Python matplotlib等生成的图表可以尝试在导出时降低曲线的点数或简化图形。使用pdfcrop很多矢量图包含大量空白边界。使用pdfcrop工具LaTeX发行版通常自带裁剪掉这些空白能显著减小文件大小和编译时的内存占用。分步编译在写作阶段可以先用低分辨率或占位图片\includegraphics[width\linewidth]{placeholder.png}来布局和编写标题、引用。等最终定稿时再替换为高清原图。这能极大提升编辑-编译-预览的循环速度。考虑使用standalone宏包生成子图对于极其复杂的组合图可以先用standalone文档类分别生成每个子图的PDF然后将这些PDF作为“图片”插入到主文档的subfigure中。这相当于将编译压力分散了。5.5 与tikz/pgfplots等绘图宏包的结合如果你直接用tikz或pgfplots在LaTeX中绘制图表并希望将它们作为子图方法完全一样。只需将\includegraphics命令替换为相应的绘图代码即可。\begin{subfigure}[b]{0.45\textwidth} \centering \begin{tikzpicture} \begin{axis}[...] \addplot [...]; \end{axis} \end{tikzpicture} \caption{TikZ绘制的曲线} \label{fig:sub_tikz} \end{subfigure}这种方式的好处是所有图表主图、子图的字体、线宽、样式都完全由文档的宏包设置统一控制保证了绝对的视觉一致性这是插入外部图片无法比拟的优势。6. 从理论到实践一个完整的可复现案例让我们通过一个模拟真实科研场景的完整案例将上述所有知识点串联起来。假设我们要撰写一篇小报告展示对某数据集使用三种不同预处理方法方法A、B、C后再用两种分类器SVM和Random Forest进行分类的结果。我们需要一个2x3的网格来展示六组ROC曲线并附上一个汇总性能的表格。步骤1准备图片我们生成了6张PDF格式的ROC曲线图命名为roc_A_SVM.pdf,roc_A_RF.pdf,roc_B_SVM.pdf,roc_B_RF.pdf,roc_C_SVM.pdf,roc_C_RF.pdf。步骤2编写LaTeX代码\documentclass[11pt, a4paper]{article} \usepackage{graphicx} \usepackage{subcaption} \usepackage{caption} \usepackage{float} \usepackage{hyperref} \usepackage{cleveref} \usepackage{booktabs} % 用于绘制更美观的表格 \usepackage{array} % 用于表格列格式定义 % 设置图表标题样式 \captionsetup[figure]{fontsmall, labelfontbf} \captionsetup[subfigure]{fontfootnotesize, labelformatparens} \begin{document} \section{实验结果} 本节展示了三种预处理方法A, B, C结合两种分类器SVM, RF在测试集上的ROC曲线对比如\cref{fig:roc_grid}所示。总体性能指标汇总于\cref{tab:summary}。 % 2x3 网格子图 \begin{figure}[H] % 此处为了演示使用[H]实际中请根据情况选择 \centering % 第一行预处理方法A \begin{subfigure}[b]{0.32\textwidth} \centering \includegraphics[width\linewidth]{roc_A_SVM.pdf} \caption{SVM (A)} \label{fig:roc_a_svm} \end{subfigure} \hfill \begin{subfigure}[b]{0.32\textwidth} \centering \includegraphics[width\linewidth]{roc_A_RF.pdf} \caption{RF (A)} \label{fig:roc_a_rf} \end{subfigure} \hfill \begin{subfigure}[b]{0.32\textwidth} \centering \includegraphics[width\linewidth]{roc_B_SVM.pdf} \caption{SVM (B)} \label{fig:roc_b_svm} \end{subfigure} \\[6pt] % 换行并增加间距 % 第二行预处理方法B和C \begin{subfigure}[b]{0.32\textwidth} \centering \includegraphics[width\linewidth]{roc_B_RF.pdf} \caption{RF (B)} \label{fig:roc_b_rf} \end{subfigure} \hfill \begin{subfigure}[b]{0.32\textwidth} \centering \includegraphics[width\linewidth]{roc_C_SVM.pdf} \caption{SVM (C)} \label{fig:roc_c_svm} \end{subfigure} \hfill \begin{subfigure}[b]{0.32\textwidth} \centering \includegraphics[width\linewidth]{roc_C_RF.pdf} \caption{RF (C)} \label{fig:roc_c_rf} \end{subfigure} \caption{不同预处理方法与分类器组合的ROC曲线对比。其中(a)(b)为方法A(c)(d)为方法B(e)(f)为方法C。} \label{fig:roc_grid} \end{figure} % 性能汇总表格 \begin{table}[htbp] \centering \caption{不同方法组合下的AUC与F1分数汇总} \label{tab:summary} \begin{tabular}{lcccccc} \toprule \textbf{方法} \multicolumn{2}{c}{\textbf{AUC}} \multicolumn{2}{c}{\textbf{F1-Score}} \\ \cmidrule(lr){2-3} \cmidrule(lr){4-5} SVM RF SVM RF \\ \midrule 预处理 A 0.92 0.94 0.88 0.90 \\ 预处理 B 0.95 \textbf{0.97} 0.91 \textbf{0.93} \\ 预处理 C 0.89 0.91 0.85 0.87 \\ \bottomrule \end{tabular} \end{table} 如\cref{fig:roc_grid}与\cref{tab:summary}所示预处理方法B结合随机森林分类器取得了最佳性能AUC0.97F10.93。具体来看从\cref{fig:roc_b_rf}可见其ROC曲线最接近左上角而\cref{fig:roc_a_svm,fig:roc_c_svm}显示方法A和C下的SVM性能相对较弱。 \end{document}步骤3编译与调试使用pdflatex编译主文档。如果遇到“未定义引用”的警告是正常的因为标签的引用信息在第一轮编译时还未生成。再次运行pdflatex一次有时需要两次交叉引用和cleveref的引用就会变得正确。如果图片路径不对检查图片文件是否与.tex文件在同一目录或者使用正确的相对路径如./figures/roc_A_SVM.pdf。这个案例展示了如何将复杂的多图数据组织得清晰、专业。通过子图网格读者可以迅速进行横向不同分类器和纵向不同预处理方法的对比。而紧随其后的表格则提供了精确的数值补充。文中通过\cref进行的交叉引用将图表与文字叙述紧密地结合在一起形成了一个完整、自解释的论证单元。这正是LaTeX排版特别是其子图功能在学术和专业写作中强大生产力的体现。掌握它你交付的将不仅仅是内容更是令人信服的专业形式。