bookdown输出的HTML文件无法显示ggplot2生成的图片该如何解决？

根因梳理 #

1. 输出格式配置缺失：当前index.Rmd和_output.yml仅配置了Grmd::docx_documentWord输出格式，未适配HTML输出需求，bookdown生成HTML时参数匹配异常，导致图片引用路径渲染错误
2. 设备参数冲突：Word输出配置中指定dev: cairo_pdf，与knitr全局设置里的dev: png冲突，优先级规则混乱导致图片路径生成不符合HTML读取要求
3. 会话参数溢出：_output.yml中new_session: true是Word输出专属参数，全局生效后会导致每个章节Rmd会话独立，生成的图片路径无法同步到主HTML文件

修复方案 #

1. 更新index.Rmd的YAML头部 #

新增HTML输出格式配置，明确输出优先级：

---
title: "中文报告标题"
output: 
  bookdown::html_document2: 
    fig_caption: TRUE
    toc: true
    number_sections: true
  Grmd::docx_document: 
    fig_caption: TRUE
    force_captions: TRUE
    dev: cairo_pdf
site: bookdown::bookdown_site
---

2. 调整_output.yml配置 #

拆分不同输出格式的专属参数，避免跨格式冲突：

# HTML输出专属配置
bookdown::html_document2:
  fig_caption: TRUE
  dev: png
  dev.args: 
    type: "cairo"
  self_contained: false # 需嵌入HTML直接改为true即可，无需依赖外部图片文件夹

# Word输出专属配置
Grmd::docx_document: 
  fig_caption: TRUE
  force_captions: TRUE
  dev: cairo_pdf
  new_session: true   

3. 优化knitr全局配置 #

删除与输出配置重复的参数，避免优先级冲突：

# 全局路径与渲染逻辑配置
knitr::opts_knit$set(
  root.dir = "D:/NewProcedure2021/Rmarkdown/",
  eval.after = "fig.cap"
)

# 代码块通用配置
knitr::opts_chunk$set(
  warning = FALSE,
  message = FALSE,
  echo = FALSE,
  dpi = 100, # 原40dpi过低易模糊，调整为常规显示精度
  out.width = "90%", # 相对宽度适配不同屏幕，无需固定像素
  fig.align = "center",
  error = FALSE
)

# 原有编号配置保留
options(table_counter = TRUE)
options(fig_caption_no_roman = TRUE)

4. 绘图代码验证 #

现有的ggplot绘图逻辑无需修改，只需确保每个绘图代码块最后直接返回ggplot对象即可，不要仅赋值不输出（当前patchwork组合图的写法p1/p2/p3 + plot_layout(ncol = 1,guides = "collect")符合要求）。

异常排查 #

如果修改后仍无法显示，执行以下操作：

• 删除旧缓存文件：清空_bookdown_files文件夹、旧_main.html文件后重新构建，避免旧缓存干扰
• 开启自包含模式：将_output.yml中HTML配置的self_contained改为true，所有图片会直接嵌入HTML文件，无需依赖外部路径，移动文件也不会出现图片丢失问题

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