LaTeX 实验结果表怎么做?三线表、小数对齐与分组表头
论文里的实验结果表,通常用三个宏包组合完成:booktabs 画三线表,siunitx 的 S 列让数字按小数点对齐,\multicolumn 加 \cmidrule 做“数据集 A / 数据集 B”这样的分组表头。下面从一份示例数据出发,给出可以编译的完整源码,并逐项说明最佳值加粗、缺失值、单位、表注和数字核对。
示例数据
下面的数字只用于演示,不来自真实实验。假设四种方法在两个数据集上各跑了三次,取平均值后整理成 CSV:
method,params_m,acc_a,f1_a,acc_b,f1_bBaseline,11.2,84.3,82.1,76.5,74.0Prior work,340,87.1,85.6,,Baseline + aug.,11.2,86.7,85.0,78.9,77.2Ours,12.8,88.2,86.4,80.3,79.6Prior work 在数据集 B 上没有报告结果,所以最后两个字段为空。参数量一栏既有 11.2,也有整数 340,正好用来演示小数对齐。
完整源码
保存为 main.tex,用 pdfLaTeX 编译。示例使用 article 文档类,加载 booktabs、siunitx 和 caption。
\documentclass[a4paper,11pt]{article}\usepackage{booktabs}\usepackage{siunitx}\usepackage{caption}\captionsetup[table]{position=above}\sisetup{ reset-text-series = false, text-series-to-math = true,}\begin{document}\begin{table}[htbp] \centering \caption{Results on two benchmarks (illustrative data). Best values in each column are in bold.} \label{tab:results} \begin{tabular}{ l S[table-format=3.1] S[table-format=2.1] S[table-format=2.1] S[table-format=2.1] S[table-format=2.1] } \toprule & & \multicolumn{2}{c}{Dataset A} & \multicolumn{2}{c}{Dataset B} \\ \cmidrule(lr){3-4} \cmidrule(lr){5-6} Method & {Params (M)} & {Acc (\%)} & {F1 (\%)} & {Acc (\%)} & {F1 (\%)} \\ \midrule Baseline & 11.2 & 84.3 & 82.1 & 76.5 & 74.0 \\ Prior work & 340 & 87.1 & 85.6 & {--} & {--} \\ Baseline + aug. & 11.2 & 86.7 & 85.0 & 78.9 & 77.2 \\ Ours & 12.8 & \bfseries 88.2 & \bfseries 86.4 & \bfseries 80.3 & \bfseries 79.6 \\ \bottomrule \end{tabular} \medskip \footnotesize Mean of three runs; -- means not reported.\end{table}Table~\ref{tab:results} compares four methods.\end{document}编译后,PDF 中有一张带标题的三线表:顶部是跨两列的 Dataset A、Dataset B,各自下方有一条短横线;参数量一栏的 340 与 11.2、12.8 的整数部分对齐;最后一行四个指标加粗;表下是一行小字表注。
流程示意:CSV、LaTeX 源码与排版结果中的数字一一对应。为便于阅读,图中只保留了两行数据和三列。
三线表:booktabs 的三条横线
booktabs 提供四条命令:
| 命令 | 位置 | 作用 |
|---|---|---|
\toprule | 表格第一行之前 | 较粗的顶线 |
\midrule | 表头与数据之间 | 较细的中线 |
\bottomrule | 最后一行之后 | 较粗的底线 |
\cmidrule(lr){a-b} | 分组表头下方 | 只覆盖第 a 到 b 列的短横线 |
这几条线的上下自带间距,所以表格不会显得拥挤。使用 booktabs 时通常不画竖线,也不要和 \hline 混用,否则线宽不一致。期刊模板若另有规定,以模板为准。
示例中的 caption 宏包和 \captionsetup[table]{position=above} 用于处理标题间距。表格标题习惯放在表格上方,而 article 默认按标题在下方设置间距,不加这两行时,标题会紧贴顶线。\label 要写在 \caption 之后,引用编号才正确。
小数对齐:siunitx 的 S 列
普通的 c 列把每个单元格居中。数字的位数不同时,小数点就会错开:
\begin{tabular}{lcc} \hline Method & Params (M) & Acc (\%) \\ \hline Baseline & 11.2 & 84.3 \\ Prior work & 340 & 87.1 \\ \hline\end{tabular}这段代码中 340 被居中放置,与 11.2 的小数点不在一条线上。把列类型换成 S,siunitx 会把每个数字拆成整数部分和小数部分,再按小数点对齐:
对齐示意:左侧为 c 列,右侧为 S[table-format=3.1]。340 没有小数部分,个位与其他数字的个位对齐。
table-format 告诉 siunitx 预留多少位:
3.1:整数部分最多 3 位,小数 1 位,用于11.2到340。2.1:整数 2 位、小数 1 位,用于84.3这样的百分数。- 有正负号时写成
+2.1等形式,带不确定度时写成2.1(1),见后文。
table-format 只影响列宽和对齐,不会改动数字。设得过小时,数字会超出预留宽度,与表头不齐,这时按最长的数字调整即可。
S 列中的非数字内容必须用花括号包住。表头 {Acc (\%)} 和缺失值 {--} 都是这样处理的。忘记加花括号时,siunitx 会把它们当作数字解析,报出 Invalid number 错误并停止编译。
分组表头:\multicolumn 与 \cmidrule
分组表头需要两行:
& & \multicolumn{2}{c}{Dataset A} & \multicolumn{2}{c}{Dataset B} \\\cmidrule(lr){3-4} \cmidrule(lr){5-6}Method & {Params (M)} & {Acc (\%)} & {F1 (\%)} & {Acc (\%)} & {F1 (\%)} \\- 第一行开头的两个
&留出 Method 和 Params 两列。\multicolumn{2}{c}{Dataset A}合并第 3、4 列,Dataset B 合并第 5、6 列。合并后的列数加上空单元格,必须等于表格的总列数 6。 \cmidrule(lr){3-4}在第 3 到 4 列下方画短横线。(lr)让线的左右两端各缩进一点,两组横线之间留出空隙,读者能看出它们属于不同分组。\multicolumn是 LaTeX 内置命令,\cmidrule来自booktabs。在 S 列上使用\multicolumn时,合并单元格按指定的c对齐,不参与数字解析,所以 Dataset A 不需要花括号。
如果一个表头需要跨两行,例如左侧的 Method 想垂直居中,可以使用 multirow 宏包的 \multirow。三线表中更常见的做法是把这类标题放在第二行,第一行留空,示例就是这样处理的。
最佳值、缺失值、单位和表注
加粗最佳值
在 S 列中加粗,示例使用了 \bfseries 88.2,并在导言区设置:
\sisetup{ reset-text-series = false, text-series-to-math = true,}siunitx 默认会重置字体粗细,这两个选项让单元格里的 \bfseries 生效,数字仍按小数点对齐。旧版教程中常见的 detect-weight 选项,在本文测试的 siunitx v3.6.7 中会提示已弃用,日志建议改用上面两个选项。
加粗前先逐列确认最大值。本例中 Ours 在四个指标上都最高:数据集 A 为 88.2 和 86.4,数据集 B 为 80.3 和 79.6。参数量越小越好,不属于“最高即最佳”的列,示例没有加粗。表头或标题应说明加粗规则,指标越低越好时也要标注,例如在表头写 Loss ($\downarrow$)。
缺失值
示例用 {--} 表示没有报告的结果,在 PDF 中显示为短横线,并在表注中说明含义。也可以写 {n/a},全文统一即可。不要把缺失值写成 0,读者会误以为结果是 0。
单位
单位写在表头,单元格中只放数字,例如 {Acc (\%)}、{Params (M)}。需要标准单位时,可以用 siunitx 的 \unit:
\begin{tabular}{l S[table-format=2.1(1)] S[table-format=3.0]} \toprule Method & {Acc (\%)} & {Latency (\unit{\milli\second})} \\ \midrule Baseline & 84.3(4) & 12 \\ Ours & 88.2(3) & 105 \\ \bottomrule\end{tabular}这段代码在导言区加入 \sisetup{uncertainty-mode = separate} 后,84.3(4) 显示为 84.3 ± 0.4,88.2(3) 显示为 88.2 ± 0.3。括号中的数字表示最后一位的不确定度,table-format=2.1(1) 为它预留一位。论文要写标准差或标准误时,在表注中说明是哪一种、基于几次运行。
表注
示例在 tabular 之后用 \footnotesize 写了一行说明,内容包括平均次数和 -- 的含义。表注较多、需要 a、b 等标记时,可以考虑 threeparttable 宏包。期刊模板通常对表注格式有要求,提交前查看作者指南。
核对数字:从数据到表格不能改值
结果表最常见的问题是抄错数字。建议在每次修改后检查:
- 舍入在数据阶段完成。 CSV 里的数字保留几位,表格里就写几位。
siunitx也能舍入,例如\num[round-mode=places, round-precision=1]{88.15}输出 88.2,86.449输出 86.4,但这会让源码中的数字和 PDF 中的数字不一致,复核时容易遗漏。 - 逐行对照。 示例 CSV 有 4 行数据,表格也应有 4 行;每行 5 个数值字段,对应表格的 5 个 S 列。空字段对应
{--}。 - 重新确认最佳值。 增删一行或修改数据后,加粗位置可能失效。
- 核对单位与百分号。 0.843 与 84.3% 不能混在同一列。
数据较多时,可以用脚本从 CSV 生成表格行,再把生成的结果粘贴到 LaTeX 中,减少手工抄写。无论用哪种方式,最后都要对照 PDF 检查一遍。
常见问题
| 症状 | 原因 | 修改方法 |
|---|---|---|
Package siunitx Error: Invalid number '(' | S 列中的表头文字没有加花括号 | 写成 {Acc (\%)} |
Invalid number '--' | 缺失值没有加花括号 | 写成 {--} |
Undefined control sequence 指向 \toprule 或 \cmidrule | 未加载 booktabs | 在导言区加入 \usepackage{booktabs} |
| 标题紧贴顶线 | 标题放在表格上方,但间距按下方设置 | 加载 caption,设置 position=above |
\bfseries 没有加粗 | siunitx 默认重置字体粗细 | 设置 reset-text-series = false 和 text-series-to-math = true |
| 数字与表头错位 | table-format 预留位数不够 | 按该列最长的数字修改 |
Extra alignment tab has been changed to \cr | 某行的 & 多于列数 | 数一数每行的分隔符,合并单元格按合并的列数计算 |
更多表格报错,可以参考AI 生成的 LaTeX 表格常见问题。
在本地或 EasyLaTeX 中验证
本地 TeX Live 或 MiKTeX 用户,在 main.tex 所在目录运行两次,第二次用于解析 \ref:
pdflatex -interaction=nonstopmode -halt-on-error main.texpdflatex -interaction=nonstopmode -halt-on-error main.tex然后检查 main.log 中有没有错误或 Overfull \hbox,再打开 PDF,对照 CSV 核对每个数字、加粗位置和表注。
在 EasyLaTeX 中,把源码放入项目主文件,确认主文件选择正确,并为这份英文 article 示例选择 pdfLaTeX。编译出错时,在 Bug 面板查看提示和 Original Log;需要帮助定位时,可以把表格源码和日志交给 Agent,逐项审阅修改后再重新编译。使用期刊模板时,保留模板要求的编译器和宏包设置,并检查模板是否已经加载 booktabs 或 siunitx。
本文的完整示例、单位与不确定度片段、舍入示例和 c 列对照片段,已用 TeXLive.net 的 pdfLaTeX(LaTeX 2026-11-01、siunitx v3.6.7)编译,日志无错误,并查看了 PDF;表中的两条报错也在同一环境中复现。没有在产品编译器或具体期刊模板中实测。
表格基础语法见基础表格、合并单元格与长表格,标题与浮动体见标题、标签与浮动体,整篇论文的格式要求见论文排版帮助。
参考资料
- booktabs 宏包文档:
\toprule、\midrule、\cmidrule的用法与三线表建议。 - siunitx 宏包文档:
S列、table-format、不确定度与舍入选项。 - caption 宏包文档:
position与标题间距。