如何在kableExtra的跨页长表中重复显示分组表头？

当用kableExtra的add_header_above给跨页长表添加分组表头（如"Group 1""Group 2"）时，默认只有底层表头会在分页后重复。要让分组表头也随每页重复，需结合longtable环境并自定义重复表头的LaTeX内容，以下是可复现的完整方案：

完整代码示例 #

YAML配置 #

---
title: "长表分组表头跨页重复演示"
output:
  pdf_document:
    latex_engine: xelatex
---

R代码部分 #

library(tidyverse)
library(kableExtra)

# 生成50行模拟数据，确保表格跨页
set.seed(123)
df <- tibble(
  Category = paste0("Item ", 1:50),
  `n (Group1)` = sample(1:100, 50, replace = TRUE),
  `% (Group1)` = round(runif(50, 0, 100), 1),
  `n (Group2)` = sample(1:100, 50, replace = TRUE),
  `% (Group2)` = round(runif(50, 0, 100), 1)
)

# 构建带重复分组表头的长表
df %>%
  kable(
    format = "latex",
    longtable = TRUE,
    booktabs = TRUE,
    col.names = c("Category", "n", "%", "n", "%")
  ) %>%
  add_header_above(
    c(" " = 1, "Group 1" = 2, "Group 2" = 2),
    bold = TRUE
  ) %>%
  kable_styling(
    latex_options = c("repeat_header", "striped"),
    # 自定义重复表头的LaTeX代码，包含分组表头和底层表头
    repeat_header_text = "\\hline \\multicolumn{1}{c}{Category} & \\multicolumn{2}{c}{\\textbf{Group 1}} & \\multicolumn{2}{c}{\\textbf{Group 2}} \\\\ \\cline{2-3} \\cline{4-5} & n & \\% & n & \\% \\\\ \\hline"
  )

关键说明 #

• longtable = TRUE：启用LaTeX的longtable环境，这是实现跨页表格的基础
• add_header_above：添加顶层分组表头，但默认不会随分页重复
• repeat_header_text：手动编写LaTeX代码定义重复表头，需与add_header_above的列分组结构完全匹配，确保每页顶部显示完整的双层表头
• booktabs = TRUE：生成更美观的专业表格线

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