用途:创建接受参数的 Quarto 或 R Markdown 报告,用同一模板渲染出多份定制化的变体,例如按部门、地区、时间段或客户生成不同版本的报告,也用于构建可按子集过滤的仪表板,以及自动化周期性报告。
主要能力:在 YAML 头部的 params: 块中定义参数名、类型与默认值;在代码块中用 params$name 引用参数,用内联表达式(如 r params$region)生成动态文本;Quarto 中可通过 #| eval: !expr params$flag 控制条件代码块;支持单次渲染与批量渲染,还可加入参数校验和按日期组织输出目录。
使用方式:先写模板文件的 YAML 参数定义,再在代码中引用参数;渲染时传入自定义参数,Quarto 使用 quarto::quarto_render(execute_params = list(...)),R Markdown 使用 rmarkdown::render(params = list(...), output_file = ...);批量生成可用 expand.grid 组合参数,再用 purrr::pwalk 逐项渲染;可用 stopifnot() 做参数校验,用 dir.create() 与 file.path() 组织输出。
限制与注意:参数名须在 YAML 与代码中大小写完全一致,否则取到 NULL;YAML 解析类型可能与代码预期不符,需显式处理;Quarto 条件执行须用 #| eval: !expr params$flag;输出文件名不唯一会互相覆盖;批量运行可能累积内存,可考虑用 callr::r() 隔离;Quarto 渲染依赖已安装的 quarto CLI,R Markdown 渲染依赖已安装的 rmarkdown。文中未提供具体收费、版本要求或性能指标,暂未提供。