如何让huxtable在PDF导出时自动跨多页拆分？

核心方案：启用LaTeX longtable环境 #

huxtable默认使用普通table环境，不支持跨页自动拆分。要实现自适应页面的分页，只需让它调用LaTeX的longtable环境——该环境会根据页面剩余空间动态拆分表格，还能自动重复表头。

修改后的示例代码 #

---
output: 
  pdf_document
---

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = FALSE)
library(huxtable)

faithful[1, 1] <- paste0(
  "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod ",
  "tempor incididunt ut, labore et dolore magna aliqua."
)

as_hux(faithful) |>
  set_wrap(everywhere, everywhere, TRUE) |>
  set_width(0.8) |>
  set_latex_table_env("longtable") |>  # 切换到longtable环境
  set_repeat_header(TRUE) |>  # 每页重复显示表头
  set_position("htb")  # 让LaTeX自动调整表格排版位置

## Shiny应用中的整合步骤
1. 读取用户上传的CSV：`df <- read.csv(input$file_upload)`
2. 格式化huxtable并启用分页：
   ```r
   hux_table <- as_hux(df) |>
     set_wrap(everywhere, everywhere, TRUE) |>
     set_width(0.8) |>
     set_latex_table_env("longtable") |>
     set_repeat_header(TRUE)

3. 导出PDF：使用huxtable::quick_pdf(hux_table, file = "output.pdf")，或结合rmarkdown模板渲染输出。

为什么split_across()无法解决问题 #

split_across()按固定行数拆分表格，完全忽略单元格文本换行后增加的行高。一旦某行因文本换行占用更多垂直空间，就会出现表格超出页面被截断的情况。而longtable基于LaTeX页面布局逻辑，动态计算剩余空间并自动拆分，从根源避免了这类问题。

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