R Markdown eval函数失效：重复代码块标签报错求助

问题背景 #

此前在R Markdown报告中，通过为多个代码块设置相同标签，结合eval参数控制仅运行符合数据集条件的代码块生成对应表格，该逻辑2-3周前可正常运行。但当前渲染时触发重复标签报错，即使手动将11个代码块的eval设为FALSE、仅1个设为TRUE，仍会报错；仅保留单个代码块时报错消失，但需保留多分支逻辑。

报错信息 #

Error in parse_block(g[-1], g[1], params.scr,
markdown_mode): 
Duplicate chunk label 'name of the label', 
which has been used for the chunk: (chunk is shown).

代码示例 #

1. eval条件设置 #

if (exists("footnote") &
    all(dataset$number_tested.x >99) &
    all(dataset$antibiotic %notin% c("gentamicin", "amoxicillin"))){
  eval_option1 <- TRUE} else {eval_option1 <- FALSE}

if (exists("footnote") &
    all(dataset$number_tested.x <100) &
    all(dataset$antibiotic %notin% c("gentamicin", "amoxicillin"))){
  eval_option2 <- TRUE} else {eval_option2 <- FALSE}

if (!exists("footnote") &
    any(dataset$antibiotic %in% c("gentamicin")) &
    all(dataset$antibiotic %notin% c("amoxicillin"))){
  eval_option3 <- TRUE} else {eval_option3 <- FALSE}

2. 代码块调用方式 #

{r, table_label, eval=eval_option1}
Set-up for producing table option 1.

{r, table_label, eval=eval_option2}
Set-up for producing table option 2.

{r, table_label, eval=eval_option3}
Set-up for producing table option 3.

3. 变量清理代码 #

{r, remove}
rm(dataset, eval_option1, eval_option2, eval_option3)

问题原因 #

该问题由knitr包的版本更新导致：knitr在解析R Markdown文档阶段，会检查所有代码块的标签唯一性，无论eval参数是TRUE还是FALSE。此前版本可能在解析时忽略eval=FALSE的代码块标签，但新版本严格执行标签唯一性校验，因此即使代码块不执行，只要标签重复就会触发报错。此问题与rmarkdown的render()函数无关，也无需强制升级R版本。

解决方案 #

方案1：为代码块设置唯一标签 #

给每个分支代码块设置不同的标签，保留原有eval控制逻辑，例如：

{r, table_label_1, eval=eval_option1}
Set-up for producing table option 1.

{r, table_label_2, eval=eval_option2}
Set-up for producing table option 2.

{r, table_label_3, eval=eval_option3}
Set-up for producing table option 3.

此方案不影响原有逻辑，是最稳妥的解决方式。

方案2：合并分支到单个代码块 #

将所有表格生成逻辑整合到一个代码块中，用if-else或switch语句判断执行分支：

{r, table_label}
if (eval_option1) {
  # Set-up for producing table option 1.
} else if (eval_option2) {
  # Set-up for producing table option 2.
} else if (eval_option3) {
  # Set-up for producing table option 3.
}

此方案减少代码块数量，从根源避免标签重复问题。

方案3：降级knitr到旧版本 #

若需临时恢复原有逻辑，可降级knitr至之前能正常运行的版本（例如使用devtools::install_version("knitr", version="x.x.x")指定版本），但不推荐长期使用，可能引发后续兼容性问题。

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