R包devtools::check报错：找不到%>%和mutate函数求助

我之前也踩过这个一模一样的坑！其实核心原因是：你的包代码能正常访问这些依赖函数，但check时运行例子的环境是独立干净的，并不会自动继承包代码里的import配置。

你已经做的步骤（在函数里加#' importFrom、DESCRIPTION里添加Imports、生成对应NAMESPACE语句），都是针对包内部代码调用依赖函数的正确配置，但例子代码是在单独的测试环境中执行的，这个环境不会自动加载这些依赖包的函数。

几种靠谱的解决方案： #

1. 用完全限定的函数名（最推荐，符合CRAN规范）

在例子里直接指明函数的来源包，不需要加载整个依赖包，就能彻底避免找不到函数的问题：

#' @examples
#' data(mtcars)
#' mtcars %>%
#'   dplyr::mutate(mpg_double = mpg * 2)

%>%也可以写成magrittr::%>%，虽然R有时能自动识别它和magrittr的关联，但写成完全限定形式会更稳妥。

2. 用条件语句包裹例子（适合依赖包非核心需求的场景）

如果这些依赖包只是例子用到，而非包核心功能必须，可以把它们加到DESCRIPTION的Suggests字段（核心依赖还是要放在Imports），然后在例子里用条件判断确保依赖存在时才运行：

#' @examples
#' if (requireNamespace("dplyr", quietly = TRUE) && requireNamespace("magrittr", quietly = TRUE)) {
#'   data(mtcars)
#'   mtcars %>%
#'     mutate(mpg_double = mpg * 2)
#' }

requireNamespace只会检查包是否安装，不会像require那样把包加载到全局环境，这种写法更符合CRAN的规范要求。

3. 导入整个依赖包（不推荐，除非必要）

如果你需要在包的大量代码和例子里都用到dplyr或magrittr的函数，可以在某个.R文件（比如zzz.R或者你的主函数文件）里添加：

#' @import dplyr
#' @import magrittr

运行devtools::document()后，NAMESPACE会生成import(dplyr)和import(magrittr)语句，这样包的环境和例子运行环境都会加载这些包的所有函数。但这种方式容易引发命名冲突，除非你确实需要大量使用，否则不建议这么做。

为什么加require(dplyr)能解决？ #

因为require()会把dplyr的函数加载到例子运行的全局环境里，例子自然就能找到mutate和%>%了，但这种方式不够严谨——如果用户没安装dplyr，例子会直接报错，CRAN的check也可能会因此提出意见，所以还是优先用前两种方法。

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