如何在外部R脚本中指定knitr全局及代码块选项？

方法1：通过envir参数注入全局knitr设置 #

直接在外部脚本创建自定义环境，在其中执行knitr::opts_chunk$set()配置全局代码块选项，再将这个环境传给render()的envir参数，Rmd渲染时会继承该环境中的knitr设置，同时不影响YAML参数的动态传递。

示例代码（外部R脚本）：

# 定义YAML动态参数
my_params <- list(
  report_title = "月度数据分析报告",
  data_source = "2024_monthly_data.csv"
)

# 创建自定义渲染环境，设置全局knitr选项
render_env <- new.env(parent = globalenv())
render_env$init_knitr_opts <- function() {
  knitr::opts_chunk$set(
    echo = FALSE,          # 全局隐藏代码
    cache = TRUE,          # 开启全局缓存
    cache.path = "cache/", # 指定缓存目录
    fig.width = 10,        # 全局设置图片宽度
    warning = FALSE        # 全局隐藏警告
  )
}
render_env$init_knitr_opts()

# 渲染Rmd，同时传递参数和自定义环境
rmarkdown::render(
  input = "analysis_report.Rmd",
  params = my_params,
  envir = render_env
)

方法2：通过YAML参数传递特定代码块选项 #

如果需要控制单个代码块的选项，可在外部脚本的params列表中添加对应配置，再在Rmd的setup代码块中动态设置目标代码块的选项。

外部R脚本：

my_params <- list(
  report_title = "用户行为分析",
  # 传递特定代码块的配置
  analysis_chunk_cache = FALSE, # 关闭"analysis"块的缓存
  plot_chunk_echo = TRUE        # 开启"plot"块的代码显示
)

rmarkdown::render(
  input = "user_behavior.Rmd",
  params = my_params
)

Rmd文件的setup块：

{r setup, include=FALSE}
# 处理特定块的选项设置
knitr::opts_chunk$set("analysis", cache = params$analysis_chunk_cache)
knitr::opts_chunk$set("plot", echo = params$plot_chunk_echo)

目标代码块示例（Rmd中）：

{r analysis}
# 这个块的缓存状态由外部params控制
summary(read.csv(params$data_source))

方法3：自定义输出格式嵌入knitr选项 #

如果需要将knitr全局选项与输出格式绑定，可用rmarkdown::output_format()创建自定义格式，在其中指定knitr配置，渲染时直接使用该格式。

示例代码（外部R脚本）：

# 创建带knitr选项的自定义HTML格式
custom_html <- rmarkdown::html_document(
  toc = TRUE,
  theme = "cerulean",
  knitr_options = list(
    chunk = list(
      cache = TRUE,
      cache.path = "html_cache/",
      fig.height = 7
    )
  )
)

# 渲染时使用自定义格式，同时传递YAML参数
rmarkdown::render(
  input = "report.Rmd",
  params = my_params,
  output_format = custom_html
)

缓存稳定性提示 #

如果动态修改knitr选项，为避免缓存失效或误读旧缓存，建议在全局knitr设置中添加cache.extra，将动态选项作为缓存依赖：

knitr::opts_chunk$set(
  cache.extra = list(params$analysis_chunk_cache, params$plot_chunk_echo)
)

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