modelsummary生成LaTeX表格在Overleaf编译报错求助

一、modelsummary LaTeX输出的必要依赖包 #

modelsummary不同后端对应的TeX包略有差异，核心依赖如下：

• tabularray：新版默认后端的核心渲染包，必须确保版本足够新（建议TeX Live 2023及以上）
• booktabs：生成专业表格横线（\toprule、\midrule等），几乎所有表格输出都需要
• amsmath：处理回归表格中的数学符号（如$\beta$、$p$值标记）
• siunitx：可选但强烈推荐，用于对齐数值列的小数点，modelsummary默认会调用其功能
• array/longtable：如果生成跨页表格，需要加载这两个包

二、编译错误的排查与解决步骤 #

1. 优先更新TeX环境与tabularray版本 #

Overleaf中直接在「菜单」→「TeX Live版本」选择最新版（比如2024）；本地TeX环境用包管理器（如TeX Live的tlmgr）更新所有包，尤其是tabularray——新版modelsummary对该包版本要求较高，旧版tabularray会不兼容新语法。

2. 最小化文档测试 #

把modelsummary输出的LaTeX代码粘贴到最简TeX文档中测试，排除其他包冲突：

\documentclass{article}
\usepackage{tabularray}
\usepackage{booktabs}
\usepackage{amsmath}
\usepackage{siunitx}
\begin{document}
% 粘贴你的modelsummary生成的LaTeX代码
\end{document}

根据报错信息针对性处理：

• 若提示tblr环境参数错误：手动简化\begin{tblr}的colspec、width等参数
• 若提示符号未定义：确认是否加载了amsmath或siunitx

3. 强制切换后端并调整参数 #

如果tabularray后端一直有问题，切换回kableExtra后端时明确配置参数，避免默认设置冲突：

library(modelsummary)
mod <- lm(mpg ~ hp, data = mtcars)
# 强制用kableExtra后端，匹配旧版输出逻辑
modelsummary(mod, 
             output = "latex", 
             backend = "kableExtra",
             booktabs = TRUE,
             escape = TRUE, # 自动转义TeX敏感字符
             format.args = list(big.mark = ",", scientific = FALSE))

4. 排查特殊字符冲突 #

如果数据或变量名包含特殊字符（如中文、下划线、&），确保开启escape = TRUE参数，让modelsummary自动转义TeX敏感字符。

三、恢复modelsummary旧版输出 #

1. 安装指定旧版本 #

卸载当前版本后安装稳定旧版（示例为1.4.0，可根据自身需求调整版本号）：

# 卸载当前版
remove.packages("modelsummary")
# 从CRAN归档安装旧版
install.packages(
  "modelsummary",
  version = "1.4.0",
  repos = "https://cran.r-project.org/src/contrib/Archive/modelsummary/"
)

若需要更旧版本，可去GitHub找到对应commit哈希，用devtools安装：

devtools::install_github("vincentarelbundock/modelsummary@abc123") # 替换abc123为目标commit哈希

安装后建议用renv锁定版本，防止后续自动更新。

2. 不降级包，模拟旧版输出 #

如果不想降级，用kableExtra后端并调整参数，尽量匹配旧版表格样式：

modelsummary(mod,
             output = "latex",
             backend = "kableExtra",
             booktabs = TRUE,
             col.names = c("(1)"), # 手动设置列名匹配旧版
             caption = "", # 若旧版无标题
             notes = NULL) # 关闭默认注释

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