如何在RMD文件中保存数据集 解决knit导出PDF报错问题

报错触发场景 #

执行.Rmd文件Knit渲染PDF操作时，持续返回报错：

Error in eval(expr, envir, enclos): Object not found.

核心原因 #

Knit渲染.Rmd时会启动完全独立的全新R会话执行文档内所有代码，和你当前操作的R全局环境完全隔离，全局环境中存储的数据集、自定义函数、已加载包都不会自动同步到渲染会话中，直接调用全局环境内的对象就会触发上述报错。

可落地解决方法 #

• 方法1：在Rmd文档内完成数据全流程读取/处理（最推荐，可复现性最优）
  不要在Rmd文档外的交互控制台完成数据读取、清洗操作，将所有数据相关逻辑统一放在Rmd开头的setup代码块中，示例：

  # 文档开头setup块，统一完成包加载、数据读取
  library(ggplot2)
  library(dplyr)
  # 路径填写相对于.Rmd文件所在位置的相对路径，不要写本地绝对路径
  analysis_data <- read.csv("raw_data/input_data.csv", encoding = "UTF-8")
  

• 方法2：预处理后的数据存为本地R数据文件，在Rmd内加载
  如果数据集已经在全局环境中完成了多步清洗、转换，不需要把全量清洗逻辑放到Rmd中，可以先在交互控制台将处理好的数据集保存为本地R数据文件，再在Rmd中加载：
  1. 交互控制台执行保存操作，将文件存到.Rmd文件同级目录：

     # 替换为你自己的数据集对象名
     saveRDS(cleaned_analysis_data, file = "analysis_data.rds")
     

  2. Rmd开头setup块添加加载语句：

     cleaned_analysis_data <- readRDS("analysis_data.rds")
     

• 方法3：临时指定全局环境为渲染环境（仅本地调试用，不推荐正式场景使用）
  临时调试时可以不调整Rmd内容，直接在R控制台执行渲染命令，指定渲染环境为当前全局环境，无需点击RStudio界面的Knit按钮：

  rmarkdown::render("your_document.Rmd", envir = globalenv())
  

  该方案完全依赖当前全局环境的对象状态，一旦清空全局环境、更换运行设备就会复现报错，正式导出可复用文档不要使用该方法。

注意：不存在直接将全局环境数据集“导入保存”到Rmd文件内的特殊操作，所有渲染过程需要用到的对象，必须在Rmd内部代码块中有明确的生成、加载逻辑，才能保证渲染过程稳定可复现。

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