RMarkdown中图片交叉引用失效问题求助

核心问题根源 #

你的主文档使用基础的pdf_document输出格式，子文档单独设置bookdown::pdf_document2无法全局生效——交叉引用是全文档级功能，必须整个项目统一使用bookdown输出格式，同时配合正确的引用语法与编译流程。

具体解决步骤 #

1. 统一主文档输出格式为bookdown::pdf_document2
   修改主Rmd的YAML头，替换原有的pdf_document配置：

   ---
   output: 
     bookdown::pdf_document2:
       number_sections: true
       keep_tex: true
       fig_caption: yes
       latex_engine: pdflatex
       extra_dependencies: ["flafter"]
   ---
   

   子文档的YAML可简化，无需重复设置输出格式（主文档配置会覆盖子文档）：

   ---
   title: "SchoolInBeeld"
   author: "Marja"
   date: "`r Sys.Date()`"
   ---
   

2. 使用bookdown标准交叉引用语法
   在文本中引用图片时，采用\@ref(fig:标签名)格式，注意是圆括号而非LaTeX的冒号语法：

   例如引用学校华夫图：\@ref(fig:Waffleplot-school)，引用全国基准图：\@ref(fig:Waffleplot-landelijk)
   

   确保标签名与代码块的label完全一致（区分大小写）。

3. 采用bookdown专属编译方式
   不要使用普通的「Knit」按钮，而是：

   • 在RStudio中点击右上角「Build」面板，选择「Build Book」
   • 或在控制台运行R命令：

     bookdown::render_book("你的主文件名.Rmd")
     

   普通Knit仅编译单个文档，无法触发bookdown的交叉引用解析逻辑。

4. 检查代码块配置细节

   • 确保代码块label无特殊字符（你的Waffleplot-school是合法格式）
   • 子文档中fig.cap=cap1需保证cap1变量已在主/子文档中正确定义，例如：

     cap1 <- "\\textcolor{TIGcaptioncolor}{Leerlingen per schoolsoort 21/22 landelijk}"
     

     注意字符串中的反斜杠需用双反斜杠转义。

验证方式 #

编译完成后，查看生成的.tex文件：确认图片标签已正确定义（如\label{fig:Waffleplot-school}），引用处已替换为\ref{fig:Waffleplot-school}。若配置正确，再用pdflatex编译两次（交叉引用需多次编译才能生效）。

内容的提问来源于stack exchange，提问作者Marja van der Wind