LaTeX 實驗結果表怎麼做?三線表、小數對齊與分組表頭

部落格EasyLaTeX發布日期

論文中的實驗結果表,通常由三個巨集套件搭配完成:booktabs 繪製三線表,siunitx 的 S 欄讓數字依小數點對齊,\multicolumn 配合 \cmidrule 做出「資料集 A / 資料集 B」這類分組表頭。以下從一份範例資料出發,提供可編譯的完整原始碼,並逐項說明最佳值加粗、缺漏值、單位、表註與數字核對。

範例資料

以下數字僅供示範,並非來自真實實驗。假設四種方法在兩個資料集上各跑三次,取平均後整理成 CSV:

Plain text
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.6

Prior work 沒有回報資料集 B 的結果,所以最後兩個欄位是空的。參數量一欄同時有 11.2 與整數 340,剛好可以用來示範小數對齊。

完整原始碼

存成 main.tex,以 pdfLaTeX 編譯。範例使用 article 文件類別,載入 booktabs、siunitx 與 caption。

LaTeX
\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 欄會把每個儲存格置中。數字位數不同時,小數點就會錯開:

LaTeX
\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

分組表頭需要兩列:

LaTeX
& & \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,並在導言區設定:

LaTeX
\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:

LaTeX
\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 巨集套件。期刊範本通常對表註格式有規定,投稿前請查閱作者指南。

核對數字:從資料到表格不能改值

結果表最常見的問題是抄錯數字。建議每次修改後檢查:

  1. 在資料階段完成四捨五入。 CSV 中的數字保留幾位,表格就寫幾位。siunitx 也能做四捨五入,例如 \num[round-mode=places, round-precision=1]{88.15} 輸出 88.2,86.449 輸出 86.4,但這會讓原始碼與 PDF 中的數字不一致,複核時容易遺漏。
  2. 逐列對照。 範例 CSV 有 4 列資料,表格也應有 4 列;每列 5 個數值欄位,對應表格的 5 個 S 欄。空欄位對應 {--}。
  3. 重新確認最佳值。 增刪一列或修改資料後,加粗位置可能已不正確。
  4. 核對單位與百分比符號。 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:

Shell
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;表中的兩項錯誤也在同一環境中重現。尚未在產品編譯器或特定期刊範本中實測。

表格基礎語法請見基本表格、合併儲存格與長表格,標題與浮動物件請見標題、標籤與浮動物件,整篇論文的格式要求請見論文排版說明。

參考資料