Bookdown项目包加载疑问：单章节预览报错%>%未找到

这个问题我之前帮不少Bookdown用户排查过，其实核心是Bookdown的章节渲染机制容易被忽略，完全不用在每个章节重复加载包，下面给你拆解原因和解决方案：

为什么会出现这个问题？ #

• 单章节预览时：Bookdown默认会单独运行当前章节的R代码，不会自动执行Index.Rmd里的包加载逻辑，所以即使你在Index.Rmd里加载了dplyr，单独预览章节时环境里并没有这个包。
• 整本书渲染时也出错：大概率是Index.Rmd里的包加载代码块有问题，比如设置了eval=FALSE，或者渲染流程没有正确执行Index.Rmd的前置代码。

最优解决方案：全局Setup脚本 #

推荐用Bookdown的全局配置来统一管理包加载，一步解决所有问题：

1. 创建一个单独的setup.R文件，把所有需要加载的包和全局设置放进去：

   # setup.R
   library(dplyr)
   # 其他你需要的包，比如：
   # library(ggplot2)
   # library(tidyr)
   # 全局knitr设置
   knitr::opts_chunk$set(echo = TRUE, warning = FALSE, message = FALSE)
   

2. 在项目根目录的_bookdown.yml文件中添加配置，让每个章节渲染前都先运行这个脚本：

   before_chapter_script: "setup.R"
   

这样不管是预览单章节还是渲染整本书，每个章节的代码运行前都会自动加载setup.R里的包，再也不会出现%>%找不到的问题。

其他可选方案 #

如果不想单独创建setup.R，也可以调整Index.Rmd的设置：

• 确保Index.Rmd里的包加载代码块没有设置eval=FALSE，并且把这个代码块放在最前面，设置include=FALSE（不显示在书里）：

  ```{r setup, include=FALSE}
  library(dplyr)
  knitr::opts_chunk$set(echo = TRUE)
  

  这种方式在**整本书渲染**时有效，但单章节预览时还是不会自动执行`Index.Rmd`的代码，所以需要你手动先运行这个代码块，或者用上面的全局Setup脚本更省心。
  
  

排查整本书渲染失败的额外提示 #

如果整本书渲染也报错，检查一下：

• Index.Rmd是不是被设置为了bookdown::gitbook的起始文件？确认_bookdown.yml里的rmd_files有没有包含Index.Rmd（默认是包含的，但如果手动修改过可能会遗漏）。
• 包加载代码块有没有拼写错误，比如library(dplry)这种笔误。

我自己维护大型Bookdown项目时一直用全局Setup脚本的方式，既统一又省心，完全不用在每个章节重复写包加载代码。

内容的提问来源于stack exchange，提问作者r.bot