开发R包使用dtplyr时如何不导入全部data.table函数？

问题根源 #

你遇到的报错本质是：.并不是普通的R函数，而是data.table自定义的非标准评估语法糖，在代码解析阶段会被自动替换为list()，该语法仅在data.table的求值上下文内生效。dtplyr转译dplyr代码时会生成含.、:=这类data.table专属语法的表达式，仅调用requireNamespace("data.table")只会确认包已安装，不会激活对应的语法解析规则，因此无法识别.符号。 #

可行解决方案（无需全量导入data.table） #

• 方案1：仅导入data.table的语法专属符号
  这是适配成本最低的方案，仅需在你的包的roxygen导入声明中添加2个特殊符号即可，不会导入data.table的其他业务函数，完全不会污染你的包命名空间：

  #' @importFrom data.table . `:=`
  

  该方案的原理是data.table的NAMESPACE实际已经导出了这两个语法相关的特殊符号，单独导入后dtplyr生成的表达式就能在你包的命名空间内正常识别对应语法，无需全量导入data.table的上百个函数。
• 方案2：临时指定求值环境（完全不导入任何data.table符号）
  如果连这两个符号都不想导入到你的包命名空间，可以在所有调用dtplyr结果求值（即collect()/as.data.table()/as_tibble()）的代码外层，用withr::with_namespace指定求值环境为data.table的命名空间：

  res <- withr::with_namespace("data.table", {
    your_dtplyr_pipeline %>% collect()
  })
  

  该方案完全不会在你包的命名空间中留下任何data.table相关的导入记录，仅在执行dtplyr代码的瞬间临时使用data.table的求值规则。

注意事项 #

• 不要在你的包中使用@import data.table全量导入，避免和你现有函数产生命名冲突
• 确保你的DESCRIPTION文件中已经将dtplyr和data.table都加入Imports字段，保证用户安装你的包时会自动安装对应依赖

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