R脚本Spin编译时chunk选项eval=FALSE失效触发语法报错

在RStudio中点击「Compile Report」对R脚本执行Spin编译操作时，运行如下设置了eval=FALSE的代码块：

#+ eval = FALSE
This line should not be syntax-checked, but it is.

会返回如下语法解析错误：

Error in parse(text = x, keep.source = TRUE) : 
  <text>:2:6: unexpected symbol
1: #+ eval = FALSE
2: This line

逻辑等效的Rmd代码块执行Knit编译时可正常运行，对应代码如下：

```{r, eval = FALSE}
Using Rmd, eval=FALSE disables the syntax-check, and does not error
```

「设置了eval=FALSE的Spin代码块即使存在语法不正确的内容，也不会触发编译报错」的预期完全合理，该报错是Spin与Rmd的编译逻辑差异导致，不属于写法错误。

• 两者编译流程顺序存在本质区别：Rmd编译时会先拆分文档结构，识别到eval=FALSE的代码块后，直接跳过块内内容的R语法解析步骤，不会将块内容传给R解析器；Spin处理R脚本时，会在读取任何块选项之前，先把整个脚本的全部内容提交给R做全量语法解析，解析通过后才会读取块选项、判断对应代码块是否需要执行。
• Spin场景下的eval=FALSE选项仅控制代码块是否实际运行，不会跳过块内内容的语法检查环节，和Rmd中同名选项的作用范围不一致，属于两个编译模式的已知行为差异。

• 将非R语法、不需要执行的内容转为Spin普通正文：Spin格式中，单独行以#'开头的内容会被识别为Markdown正文，不会进入R语法解析流程，也不会作为代码执行，示例：

#' 以下为普通说明文本，不会触发语法检查
This line should not be syntax-checked, but it is.

• 为代码块指定非R引擎：显式标记块为文本类块后，Spin不会用R语法规则校验块内内容，配合eval=FALSE即可跳过执行，示例：

#+ text, eval=FALSE
This line should not be syntax-checked, but it is.

• 临时调试场景下，可将不符合R语法的内容用R注释符号#包裹，同时设置块选项comment=''避免输出多余注释标记，即可绕过语法检查。

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