R Markdown网站：能否为每个编织文件创建独立运行环境？

作为经常帮人排查R Markdown问题的开发者，我太懂你说的这种痛苦了——用rmarkdown::render_site()搭网站时，knitr居然默认复用同一个环境，前一个页面定义的变量、函数会偷偷留在环境里，后面的页面一不小心用到同名对象，就会出各种莫名其妙的bug，排查起来头都大。

先捋清楚问题根源 #

正常来说，我们默认每个R Markdown页面应该是独立运行的，但render_site()为了提升渲染效率，会让所有页面共享同一个编织环境。这就导致页面A定义的x <- 10，页面B哪怕没定义过x，打印出来也是10，完全不符合预期。

你的最小复现场景（核心逻辑） #

就像你提到的5个文件的示例：

• testing.Rproj：项目配置
• index.Rmd：悄悄定义了x <- 10
• page2.Rmd：直接打印x，结果输出10（明明自己没定义啊！）
• _site.yml：网站配置文件
• 还有可能的构建脚本

这种跨页面的变量污染，就是共享环境搞的鬼。

给你三个靠谱的解决办法 #

办法1：每个页面开头手动清空环境 #

在每个Rmd文件的最顶部代码块里加这段代码，直接把当前环境的所有残留对象清干净：

# 清空所有对象（包括隐藏的）
rm(list = ls(all.names = TRUE))
# 卸载之前加载的非基础包，还原默认搜索路径
search() |> 
  setdiff(base::.BaseNamespaceEnv) |>
  setdiff("package:base") |>
  lapply(detach, character.only = TRUE, unload = TRUE)

⚠️ 小提醒：这样会把之前加载的包都卸载，所以每个页面记得重新加载自己需要的包哦。

办法2：自定义渲染函数，强制每个页面用新环境 #

别直接用rmarkdown::render_site()了，自己写个函数，逐个渲染每个文档，每个都分配全新的环境：

render_site_isolated <- function() {
  # 获取网站配置里的所有文档
  site_config <- rmarkdown::site_config()
  all_docs <- site_config$documents$input
  
  # 循环渲染每个文档，每个都用独立环境
  for (doc in all_docs) {
    rmarkdown::render(
      input = doc,
      envir = new.env(parent = globalenv())
    )
  }
  
  # 最后生成网站结构
  rmarkdown::render_site(output_format = NULL, envir = new.env(parent = globalenv()))
}

之后调用这个render_site_isolated()来构建网站，每个页面的环境完全隔离，再也不会有变量串味的问题。

办法3：设置knitr全局选项，默认用新环境 #

新建一个_setup.R文件，里面写这段代码：

# 让knitr编织每个文档时都用新环境
knitr::opts_knit$set(envir = new.env(parent = globalenv()))

然后在_site.yml里配置include: _setup.R，这样所有页面都会自动加载这个设置，编织时自动使用新环境，不用每个页面单独加代码，更省心。

验证一下是否生效 #

修改你的测试页面：

1. 在index.Rmd里定义x <- 10并打印
2. 在page2.Rmd里尝试打印x，如果报错object 'x' not found，说明环境隔离成功啦！

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