RStudio安装babel组件后编织PDF时图表及交叉引用无法渲染

问题成因 #

• babel是LaTeX宏包而非R包，因此不会出现在R已安装包列表中，无法通过R的包管理工具卸载，tinytex::check_installed("babel")返回TRUE是验证的TeX环境的包安装状态，属于正常结果。
• 你遇到的图表丢失、交叉引用失效与babel警告是两个关联但独立的问题：babel触发的编译异常会中断图表生成流程，且修改语言配置后未清理缓存导致旧的异常参数残留，即使改回英文配置问题也会复现。

解决方案 #

步骤1：补全TeX端依赖，消除babel警告 #

运行以下R命令安装缺失的法语断字规则包，修复编译警告：

# 安装法语断字相关依赖
tinytex::tlmgr_install(c("hyphen-french", "frenchb"))
# 重建TeX格式文件
tinytex::fmtutil(usermode = TRUE, all = TRUE)

步骤2：清理项目缓存，重置编织环境 #

旧的编译缓存会保留之前的异常LaTeX配置，必须完全清理：

• 点击RStudio编织按钮右侧下拉菜单，选择「清除针织缓存」
• 手动删除项目根目录下的_bookdown_files文件夹、所有后缀为.tex/.aux/.log/.out的临时文件

步骤3：修正YAML配置，强制指定语言规则 #

确认你的输出格式为支持交叉引用的bookdown::pdf_document2，同时在YAML头中强制指定babel使用英语，避免法语配置残留：

---
lang: "en-GB"
output:
  bookdown::pdf_document2:
    keep_tex: FALSE
    number_sections: TRUE
header-includes:
  - \usepackage[english]{babel}
---

注意：如果你用的是默认的rmarkdown::pdf_document格式，本身不支持@ref()格式的交叉引用，必须切换为bookdown::pdf_document2才能正常解析引用语法。

步骤4：重新编织验证 #

完成上述操作后重新编织PDF，此时babel警告会消失，图表和交叉引用会正常渲染。如果仍有问题，可以临时将YAML中的keep_tex设为TRUE，检查生成的.tex文件中是否仍有残留的法语babel配置。

内容的提问来源于stack exchange，提问作者Clément LVD