LaTeX子图排版指南：从subfigure到subcaption的演进与实战

1. 项目概述为什么LaTeX子图排版是学术写作的“必修课”如果你正在用LaTeX撰写论文、报告或者任何包含多张插图的文档那么“子图”排版绝对是你绕不开的一个核心技能点。我见过太多研究生、工程师在初学LaTeX时面对需要将几张图片并排展示、并统一编号和说明的需求时一头扎进搜索引擎然后被subfigure、subfig、subcaption这几个长得像兄弟一样的宏包名字搞得晕头转向。最后往往随便选一个代码能跑通就谢天谢地至于间距是否美观、引用是否精准、与hyperref宏包是否冲突就顾不上了。这其实非常可惜。LaTeX排版的精髓在于“内容与格式分离”让你专注于写作本身而把排版交给专业的排版引擎。子图排版正是这一理念的集中体现你只需要在文档中声明“这里有三张图它们是一个整体分别叫(a)、(b)、(c)”LaTeX就会自动处理编号、对齐、间距甚至在图表目录中为你生成整洁的条目。掌握它不仅能让你提交的文档在视觉上更专业更能避免在投稿前手忙脚乱地调整格式这种糟心事。今天我就以一名常年与LaTeX打交道的过来人身份帮你彻底理清subfigure、subfig、subcaption这三个宏包的来龙去脉、优劣对比和实战写法。我们会从最古老但仍有“历史包袱”的subfigure讲起再到一度成为主流的subfig最后聚焦于目前最推荐、维护最活跃的subcaption。我会分享我踩过的所有坑比如为什么你的子图引用突然变成了“??”以及如何让子图标题和主图标题完美对齐。无论你是LaTeX新手还是想优化现有工作流的老手这篇内容都能给你提供可直接“抄作业”的解决方案。2. 核心宏包演进史从subfigure到subcaption的必然选择在深入代码之前我们必须先理解这三个宏包的关系。这不是简单的三个并列选项而是一部有着明确迭代关系的“技术演进史”。选错了宏包可能会让你后续的文档编写困难重重。2.1 subfigure曾经的经典与如今的“遗产”subfigure宏包非常古老在LaTeX 2.09时代LaTeX2e之前就已存在。它的语法直观对于简单的并排图片需求写起来很快。这也是为什么你在很多古老的论文模板或教程里还能看到它的原因。\usepackage{subfigure} ... \begin{figure}[htbp] \centering \subfigure[子图A的说明]{\includegraphics[width0.45\textwidth]{fig_a.pdf}} \hfill \subfigure[子图B的说明]{\includegraphics[width0.45\textwidth]{fig_b.pdf}} \caption{这里是整个图组的标题} \label{fig:my_figure} \end{figure}它的主要问题在于兼容性。subfigure宏包与LaTeX2e的核心浮动体处理机制以及后来广泛使用的hyperref用于生成超链接、caption用于定制题注样式等宏包存在冲突。这些冲突不是报个错那么简单有时是静默的失败——比如你的子图引用(\ref{fig:my_figure-a})可能无法正确解析或者超链接指向错误的位置。此外它已经停止维护很久在现代LaTeX发行版中它通常被标记为“过时”(obsolete)。注意除非你正在维护一个十几年前的古董项目模板必须保持一致性否则在新项目中应绝对避免使用subfigure宏包。2.2 subfig承上启下的过渡方案为了解决subfigure的兼容性问题subfig宏包被开发出来。它设计了一个新的命令\subfloat并努力与caption、hyperref宏包保持友好。在相当长一段时间里它是子图排版的事实标准。\usepackage{subfig} ... \begin{figure}[htbp] \centering \subfloat[子图A的说明]{\label{fig:sub_a}\includegraphics[width0.45\textwidth]{fig_a.pdf}} \hfill \subfloat[子图B的说明]{\label{fig:sub_b}\includegraphics[width0.45\textwidth]{fig_b.pdf}} \caption{这里是整个图组的标题} \label{fig:my_figure} \end{figure}subfig比subfigure稳定得多但它也有自己的“小脾气”。例如它对子图标签(\label)的位置有比较严格的要求必须放在\subfloat命令的第二个参数即图片内容内部的最前面否则引用可能会出错。另一个问题是它虽然与caption宏包兼容但两者在定制题注样式时有时会产生微妙的相互影响需要额外的参数调整。2.3 subcaption现代LaTeX的推荐标准subcaption宏包可以看作是caption宏包的“亲儿子”或官方扩展。它由caption宏包的维护者开发因此与caption宏包实现了无缝集成同时也完美支持hyperref。这是目前CTANLaTeX宏包仓库官方推荐、维护最活跃的子图解决方案。它的语法清晰且强大\usepackage{subcaption} ... \begin{figure}[htbp] \centering \begin{subfigure}{0.45\textwidth} \centering \includegraphics[width\linewidth]{fig_a.pdf} \caption{子图A的说明} \label{fig:sub_a} \end{subfigure} \hfill \begin{subfigure}{0.45\textwidth} \centering \includegraphics[width\linewidth]{fig_b.pdf} \caption{子图B的说明} \label{fig:sub_b} \end{subfigure} \caption{这里是整个图组的标题} \label{fig:my_figure} \end{figure}为什么我强烈推荐subcaption无缝兼容与caption和hyperref宏包是天作之合几乎不会出现冲突。语法优雅它使用了subfigure环境将子图及其标题、标签封装在一起逻辑上更清晰更符合LaTeX的“环境”哲学。功能强大支持垂直排列、混合排列如2x2网格、甚至子图内部再嵌套子图等复杂布局。引用可靠引用子图如图\ref{fig:my_figure}(\ref{fig:sub_a})非常稳定生成的超链接也准确无误。维护活跃有问题更容易找到解决方案和社区支持。结论对于任何新项目请直接使用subcaption宏包。subfig可以作为已有项目的备选而subfigure则应被视为历史遗迹。3. 使用subcaption进行子图排版的完整实操指南现在我们聚焦于subcaption从环境准备到复杂布局一步步拆解。3.1 基础环境搭建与宏包加载首先在你的文档导言区\begin{document}之前加载必要的宏包。一个典型的配置如下\documentclass{article} % 或 report, book 等 \usepackage{graphicx} % 插入图片 \usepackage{subcaption} % 核心子图支持 \usepackage{hyperref} % 生成超链接可选但推荐 % caption宏包通常会被subcaption自动加载无需重复引入 \begin{document} % 你的文档内容 \end{document}这里有个关键细节subcaption宏包会自动加载caption宏包。如果你需要对题注包括主图标题和子图标题的格式进行深度定制比如改变字体、分隔符、编号样式你应该在subcaption之后再使用caption宏包提供的命令进行设置以确保你的设置能同时作用于主标题和子标题。\usepackage{subcaption} \usepackage{caption} \captionsetup{fontsmall, labelfontbf} % 设置所有题注含子图为小号、标签加粗 \captionsetup[sub]{fontscriptsize} % 单独设置子图题注为更小号3.2 单行并排子图最常用的场景这是最常见的需求将两到三张图水平排列共享一个主标题。\begin{figure}[htbp] \centering % 第一个子图 \begin{subfigure}[b]{0.32\textwidth} % [b]表示底部对齐宽度占文本宽度的32% \centering \includegraphics[width\linewidth]{architecture.pdf} \caption{系统架构图} \label{fig:arch} \end{subfigure} \hfill % 弹性填充水平空间使子图均匀分布 % 第二个子图 \begin{subfigure}[b]{0.32\textwidth} \centering \includegraphics[width\linewidth]{flowchart.pdf} \caption{算法流程图} \label{fig:flow} \end{subfigure} \hfill % 第三个子图 \begin{subfigure}[b]{0.32\textwidth} \centering \includegraphics[width\linewidth]{result.pdf} \caption{实验结果对比} \label{fig:result} \end{subfigure} \caption{本研究涉及的关键图示(a) 整体架构(b) 处理流程(c) 性能验证。} \label{fig:key_figures} \end{figure}实操要点与避坑指南宽度计算{0.32\textwidth}是子图环境的宽度。三个子图每个占32%总共96%留出了约4%的间隙由\hfill产生。这是一个经验值你可以微调如0.3或0.31来适应你的图片比例。\linewidth的妙用在子图环境内部使用width\linewidth意味着图片宽度将撑满你为子图环境指定的宽度0.32\textwidth。这比直接计算绝对宽度如width5cm要灵活得多修改子图环境宽度时图片会自动适应。对齐选项[t]/[b]/[c]subfigure环境的可选参数[b]表示子图内的内容图片标题底部对齐。如果你的子图高度不一致使用[b]可以让所有子图的标题底部对齐视觉效果更整齐。[t]是顶部对齐[c]是居中对齐默认。\hfill的作用这个命令会在其左右产生弹性空间将子图推向两侧从而实现均匀分布。如果没有它子图会紧挨在一起。3.3 多行网格状子图排列当需要展示更多图片时如4张、6张可以组织成网格状。\begin{figure}[htbp] \centering % 第一行 \begin{subfigure}[b]{0.48\textwidth} \centering \includegraphics[width0.8\linewidth]{case1_input.png} \caption{输入样本1} \label{fig:case1_in} \end{subfigure} \hfill \begin{subfigure}[b]{0.48\textwidth} \centering \includegraphics[width0.8\linewidth]{case1_output.png} \caption{输出结果1} \label{fig:case1_out} \end{subfigure} \vspace{0.5em} % 在行间添加一点垂直间距比空行更可控 % 第二行 \begin{subfigure}[b]{0.48\textwidth} \centering \includegraphics[width0.8\linewidth]{case2_input.png} \caption{输入样本2} \label{fig:case2_in} \end{subfigure} \hfill \begin{subfigure}[b]{0.48\textwidth} \centering \includegraphics[width0.8\linewidth]{case2_output.png} \caption{输出结果2} \label{fig:case2_out} \end{subfigure} \caption{两组实验的输入输出对比。上方为第一组下方为第二组。} \label{fig:grid_example} \end{figure}注意事项行间距控制使用\vspace{0.5em}来精确控制行与行之间的垂直距离这比单纯的空行\\更专业、更可控。em是相对单位与当前字体大小相关。图片缩放这里我用了width0.8\linewidth让图片在子图框内居中并留白有时比撑满整个宽度更美观尤其是当图片本身比例不协调时。3.4 混合布局与复杂排列subcaption的强大之处在于其灵活性。你可以轻松实现非对称布局。\begin{figure}[htbp] \centering % 左侧一个大图 \begin{subfigure}{0.65\textwidth} \centering \includegraphics[width\linewidth]{overview.pdf} \caption{整体概览} \label{fig:overview} \end{subfigure} \hfill % 右侧两个垂直排列的小图 \begin{subfigure}{0.3\textwidth} \centering \begin{subfigure}[t]{\linewidth} % 嵌套使用注意宽度是\linewidth \centering \includegraphics[width0.9\linewidth]{detail_a.pdf} \caption{细节A} \label{fig:detail_a} \end{subfigure} \\ \vspace{0.3em} \begin{subfigure}[b]{\linewidth} \centering \includegraphics[width0.9\linewidth]{detail_b.pdf} \caption{细节B} \label{fig:detail_b} \end{subfigure} \end{subfigure} \caption{混合布局示例左侧展示整体结构右侧垂直排列两个局部细节。} \label{fig:mixed_layout} \end{figure}这个例子展示了嵌套使用subfigure环境来实现右侧的垂直堆叠。关键在于外层的subfigure环境宽度0.3\textwidth充当了一个容器内部的两个subfigure环境宽度设为\linewidth即撑满这个容器的宽度。4. 高级定制与交叉引用技巧4.1 定制子图标题格式通过caption宏包的\captionsetup命令我们可以精细控制子图标题的样式。\usepackage{subcaption} \usepackage{caption} % 设置所有题注包括子图的标签格式为“图1.”而不是默认的“图 1:” \captionsetup{labelsepperiod} % 标签和标题之间用句点分隔 % 单独设置子图题注的格式 \captionsetup[sub]{fontfootnotesize, % 字体更小 labelfontbf, % 标签如(a)加粗 justificationcentering, % 标题居中 singlelinechecktrue} % 单行标题时也应用居中 % 如果你想改变子图标签的样式比如从(a)变成(a). \renewcommand{\thesubfigure}{(\alph{subfigure}).} % 在字母后加个点4.2 精准的交叉引用正确的引用能让读者快速定位。subcaption提供了稳定的引用机制。在正文中引用如图\ref{fig:key_figures}所示整个系统包含三个主要部分。 其中架构设计图\ref{fig:key_figures}(\ref{fig:arch})采用了微服务模式。 具体流程可参考图\ref{fig:flow}。编译后你会看到类似“如图1所示...其中架构设计图1(a)...具体流程可参考图1(b)”的效果。使用\ref{fig:key_figures}(\ref{fig:arch})这种嵌套引用的方式能确保即使主图编号因增删图表而改变子图引用依然正确。在图表目录中列出子图默认情况下\listoffigures只会列出主图标题。如果你希望子图标题也出现在图表目录中某些学位论文格式要求可以在导言区加入\usepackage{subcaption} \captionsetup[sub]{listtrue} % 将子图标题加入图表列表4.3 与hyperref宏包协同工作这是subcaption的一大优势。只要你按正常顺序加载宏包hyperref通常最后加载一切都会自动生效。\usepackage{subcaption} \usepackage{hyperref} % 或者使用hyperref的选项 \usepackage[pdftex, hidelinks]{hyperref} % hidelinks隐藏链接边框编译成PDF后所有对图和子图的引用\ref都会变成可点击的超链接直接跳转到对应的图表位置极大提升了电子文档的阅读体验。5. 常见问题排查与实战心得即使知道了正确方法实操中还是会遇到各种奇怪的问题。下面是我总结的“排坑手册”。5.1 引用显示为“??”或错误这是LaTeX新手最常遇到的问题。原因1编译次数不够。LaTeX的交叉引用需要至少编译两次才能正确解析。第一次编译pdflatex或xelatex生成.aux文件记录标签第二次编译读取.aux文件并替换正确的编号。始终编译两次如果使用了bibtex管理参考文献则需要顺序执行pdflatex-bibtex-pdflatex-pdflatex。原因2标签\label放错了位置。在subcaption中\label必须放在\caption命令之后在subfigure环境内部。放在\caption之前或subfigure环境外部都会导致引用失效。% 正确 \begin{subfigure}{...} ... \caption{...} \label{...} % 在\caption之后 \end{subfigure} % 错误示例1 \begin{subfigure}{...} \label{...} % 在\caption之前错误 ... \caption{...} \end{subfigure} % 错误示例2 \begin{subfigure}{...} ... \caption{...} \end{subfigure} \label{...} % 在环境外部错误这个标签会标记到下一个对象可能是段落或下一个浮动体上。原因3宏包冲突。如果你错误地同时加载了subfigure和subcaption或subfig几乎一定会导致引用混乱。确保只加载一个子图宏包。5.2 子图标题与图片不对齐或溢出标题过长换行如果子图标题太长LaTeX会自动换行。你可以通过手动断行\\来优化或者调整子图环境的宽度给标题留出更多水平空间。垂直对齐不一致使用subfigure环境的可选参数[t]、[b]、[c]来统一一行内所有子图的对齐基准。通常[b]底部对齐效果最好。图片高度不一致导致标题错位这是物理问题。要么在预处理图片时统一高度要么在\includegraphics中使用height参数进行强制缩放但要注意这可能扭曲图片比例。更好的做法是接受这种不完美或者用[t]顶部对齐让标题都在顶部。5.3 主图标题与子图标题间距过大默认样式下主图标题\caption和子图标题之间的垂直距离可能偏大。可以通过caption宏包调整\usepackage{caption} \captionsetup[figure]{skip5pt} % 设置图标题与上方内容的距离 % subcaption 定义的子图标题样式其skip值可以单独调整 \captionsetup[sub]{skip3pt} % 设置子图标题与图片的距离这里的skip是标题与其上方内容对于主图是子图对于子图是图片的垂直间距。多试几次找到适合你文档的值。5.4 关于“subfig”和“subcaption”宏包的选择纠结虽然我强烈推荐subcaption但如果你接手了一个大量使用subfig的旧项目全部迁移可能需要时间。一个临时兼容方案是在导言区使用\usepackage{subfig}但写作时尽量采用subfig的语法。subcaption宏包提供了一个compatibility选项可以模拟subfig的部分行为但并非百分百兼容转换时仍需测试。我的最终建议是在新项目中坚定不移地使用subcaption。它的语法更清晰文档更完善社区支持更好。花一点时间学习它会在整个项目周期中为你节省大量调试格式的时间。子图排版是LaTeX专业排版能力的体现。从混乱的图片堆砌到井然有序的图表展示其间的差距往往就是这些细节的打磨。掌握subcaption意味着你不仅解决了“怎么排”的问题更获得了应对各种复杂排版需求的底气和灵活性。下次当你需要展示一组对比实验图、一组算法步骤示意图时希望你能自信地写出清晰、健壮且美观的代码。