kable()中caption参数导致save_kable()导出LaTeX报错求助

问题原因 #

当使用save_kable将带caption的LaTeX格式表格导出为图片时，默认生成的LaTeX代码缺少table环境，而LaTeX的\caption命令必须在table或figure环境中使用，这就导致编译时抛出"! LaTeX Error: Something's wrong--perhaps a missing \item."的错误。

解决方案 #

在kbl()之后添加kable_styling(latex_options = "table_env")，让kableExtra自动为表格包裹table环境，完整代码如下：

library(tidyverse)
library(kableExtra)
library(magick)
dt <- mtcars[1:5, 1:6]
dt %>%
  kbl("latex", caption = "Recreating booktabs style table") %>%
  kable_styling(latex_options = "table_env") %>%
  save_kable(file = "a.png")

额外排查技巧 #

如果问题仍存在，可以添加keep_tex = TRUE参数保留中间生成的LaTeX文件，检查代码是否有异常：

dt %>%
  kbl("latex", caption = "Recreating booktabs style table") %>%
  kable_styling(latex_options = "table_env") %>%
  save_kable(file = "a.png", keep_tex = TRUE)

打开生成的.tex文件，确认caption是否被正确包含在\begin{table}和\end{table}之间，同时检查caption文本是否有LaTeX特殊字符（如_、&等，需转义）。

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