循环渲染Rmarkdown时参数传递失败，报错提示参数未在YAML中声明

你遇到的这个报错，核心问题出在Rmarkdown的YAML参数定义格式不符合要求，有两个关键细节没处理好：

1. YAML参数的缩进错误 #

YAML对缩进规则非常严格，params下的子参数必须比params本身缩进（通常用2个空格）。你原来的YAML里student_no和params是同一缩进级别，这会导致R无法识别它是params的子项：

错误的YAML写法：

---
title: "Student report"
params:
student_no:
---

2. 参数缺少默认值声明 #

就算缩进正确，只写student_no:而不指定默认值（比如NULL、空字符串或者具体数值），Rmarkdown的参数解析器也会判定这个参数没有被正式声明。

修改后的正确YAML头部 #

把这两个问题修正后，你的YAML应该写成这样：

---
title: "Student report"
params:
  student_no: NULL  # 缩进2个空格，同时给参数设置默认值
---

为什么这样能解决问题？ #

• 正确的缩进明确告诉R：student_no是params的一个子参数；
• 给参数设置默认值（哪怕是NULL）相当于完成了参数的“注册”，这样render()函数传递的student_no参数就能被正确匹配，不会再报“未声明”的错误。

额外小提示 #

• 确保循环代码里的ids和Rmarkdown中CandidateId的类型一致（比如都是字符型），避免因类型不匹配导致数据过滤失败；
• 尽量不要在Rmarkdown里重复使用setwd()，可以把文件路径写成相对路径，或者在循环前统一设置工作目录，减少路径混乱的问题。

备注：内容来源于stack exchange，提问作者Nick Riches