R Markdown中表格列内容超出页面容量时如何拆分过长行？

问题核心原因 #

你遇到的是LaTeX longtable环境的原生限制：longtable仅支持整表跨页，不支持单个单元格内的内容跨页拆分，所以当某一行第五列的内容高度超过单页剩余空间时就会被截断。同时你当前设置的五列宽度总和达21.5cm，已经超过A4纸默认18cm左右的文本宽度，会导致宽度设置失效，加剧内容溢出问题。

完整解决方案 #

1. 先配置R Markdown依赖（仅PDF输出需要）

在文档头部的yaml配置中添加xltabular依赖，该LaTeX包支持单元格内容跨页拆分：

output: 
  pdf_document:
    extra_dependencies: ["xltabular", "varwidth"]

如果是HTML输出可跳过这一步。

2. 调整后的完整代码

library(dplyr)
library(stringr)
library(kableExtra)

# 预处理第五列长文本，自动插入合法换行标记
df <- df %>%
  mutate(
    # 把下方的【第五列实际列名】替换为你数据框第五列的真实列名
    第五列实际列名 = linebreak(
      str_wrap(第五列实际列名, width = 65), # 字符宽度可根据实际排版调整
      align = "left"
    )
  )

df %>%
  kbl(booktabs = T, longtable = T, escape = F) %>% # escape=F 用于识别换行标记不转义
  row_spec(0, background = "#F6F6F6", color = "black") %>%
  kable_styling(
    bootstrap_options = "striped", 
    font_size = 9,
    latex_options = c("hold_position", "repeat_header"),
    position = "left"
  ) %>%
  column_spec(1, width = "1.8cm") %>%
  column_spec(2, width = "2.2cm") %>%
  column_spec(3, width = "2.2cm") %>%
  column_spec(4, width = "3.8cm") %>%
  # 调整第五列宽度，所有列宽总和控制在16-17cm以内，避免超出页面文本宽度
  column_spec(5, width = "6cm", latex_valign = "top")

如果是HTML输出，只需把预处理逻辑替换为：

df <- df %>%
  mutate(
    第五列实际列名 = str_replace_all(str_wrap(第五列实际列名, width = 80), "\n", "<br>")
  )

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