修改knitr的root.dir后include_graphics无法找文件的解决方案问询

问题背景 #

knitr允许通过knitr::opts_knit$set(root.dir = ...)修改代码块的运行目录，但在如下文件结构中：

├── Project
    ├── Fig
    │   └── Fig1.png
    └── Rmd
        └── Test.Rmd   

当在Test.Rmd的setup块中设置root.dir = '~/Project'后，使用knitr::include_graphics('Fig/Fig1.png')渲染时无法加载图片。

现有方案的优缺点 #

你提到的三个方案各有局限：

• 选项1：knitr::include_graphics(path = normalizePath('Fig/Fig1.png'), rel_path = FALSE)
  能解决问题，但手动调用normalizePath不够简洁，跨平台路径格式可能出现兼容问题。
• 选项2：knitr::include_graphics(path = "../Fig/Fig1.png", error = FALSE)
  依赖Rmd文件的固定位置，一旦移动Rmd文件路径就失效；error=FALSE会掩盖真实错误（比如图片实际不存在时也不会抛出提示）。
• 选项3：knitr::include_graphics(path = '~/Project/Fig/Fig1.png', rel_path = FALSE)
  硬编码绝对路径，项目迁移到其他目录或设备时必须手动修改路径，灵活性极差。

更优解决方案 #

方案1：使用here包管理路径（推荐） #

here包会自动识别项目根目录（基于项目中的.Rproj文件或常见项目标记），完全脱离工作目录的限制，代码健壮性极强：

# 首次使用时安装包
install.packages("here")
library(here)

# 调用include_graphics时用here构建路径
knitr::include_graphics(here("Fig", "Fig1.png"))

优势：

• 不受root.dir设置影响，也无需手动处理相对/绝对路径
• 项目结构变动（如移动Rmd文件）时，代码无需修改
• 自动适配Windows/macOS/Linux的路径格式

方案2：结合root.dir的原生knitr写法 #

如果不想额外安装包，可以在setup块中保存root.dir路径，再通过file.path构建完整路径：

# setup块中配置并保存root.dir
```{r, setup, include=FALSE}
knitr::opts_knit$set(root.dir = '~/Project')
root_dir <- knitr::opts_knit$get("root.dir")

knitr::include_graphics(file.path(root_dir, "Fig", "Fig1.png"), rel_path = FALSE)

这个方案利用knitr自身的配置，避免硬编码路径，比现有三个方案更灵活。

## 关于“修复”knitr::include_graphics的问题
这个现象并非knitr的bug，而是设计逻辑导致的：
- `root.dir`仅修改**代码块执行时的工作目录**，用于运行R代码（如读取数据、计算）
- `include_graphics`默认会将路径转换为**相对于Rmd源文件的相对路径**，目的是保证生成的输出文件（如HTML）可以独立移植（移动到其他位置时图片路径依然有效）

两者的作用场景不同，因此不存在“修复”的说法，理解逻辑差异后，选择合适的路径管理方式即可解决问题。

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