knitr::include_graphics()在RStudio正常但HTML报告渲染时找不到图片

云上老周

2026-7-5

解决knitr::include_graphics()渲染HTML后图片失效的问题

使用相对路径而非绝对路径
本地绝对路径（如C:/Documents/plot.png）仅在当前RStudio环境有效，HTML渲染后路径结构变化会导致图片找不到。建议将图片放在项目根目录的子文件夹（如figures），代码改用相对路径：
```
knitr::include_graphics("figures/plot.png")
```
提前用getwd()确认工作目录为项目根目录，若不符用setwd()切换。
确保图片被同步到输出目录
R Markdown默认不会自动复制外部图片到HTML关联目录，可在YAML头部设置：
```
output:
  html_document:
    self_contained: false
```
或者通过knitr全局参数指定图片输出路径：
```
knitr::opts_chunk$set(fig.path = "figures/")
```
规范图片命名和格式
避免文件名含中文、空格或特殊字符，改用英文+下划线命名（如my_analysis_plot.png）；同时确保图片为HTML兼容格式（PNG、JPG、SVG均可）。
清理缓存后重新渲染
旧缓存可能残留错误路径信息，执行以下代码清理缓存后重新生成HTML：
```
knitr::clean_cache()
```
也可在对应代码块添加cache = FALSE参数禁用单块缓存。