首次开发R包：如何正确配置依赖实现自动安装？

我之前也踩过一模一样的坑！你碰到的核心问题是：@import 或者 @importFrom 语句只是帮你的包在运行时导入依赖包的函数，但它完全不负责触发依赖的自动安装——这部分得靠包根目录的 DESCRIPTION 文件来配置。下面是一步步的解决方法：

• 给DESCRIPTION文件添加Imports字段
  这是关键！你需要把dplyr（以及其他所有依赖）添加到DESCRIPTION的Imports区块里。如果用roxygen2管理文档，你可以在任意一个R脚本里添加：

  #' @import dplyr
  NULL
  

  然后运行devtools::document()，roxygen2会自动把dplyr写入DESCRIPTION的Imports中。如果想指定依赖的最低版本（避免兼容问题），也可以手动修改DESCRIPTION：

  Imports:
    dplyr (>= 1.0.0)
  

• 优先用Imports而非Depends
  别把依赖放到Depends字段里！Depends会让依赖包在你的包加载时也被强制加载到用户的全局环境，很容易引发命名冲突。Imports是现代R包的标准做法：你的包可以安全使用依赖包的函数，但不会污染用户的工作空间。

• 确保用户安装时触发依赖安装
  如果用户是通过devtools::install_github("你的用户名/my_package")或者remotes::install_local("my_package.tar.gz")安装你的包，这些工具会自动检测Imports里的依赖并帮用户安装。但如果用户用基础的install.packages()安装本地包，需要提醒他们加上dependencies=TRUE参数：

  install.packages("my_package.tar.gz", repos=NULL, type="source", dependencies=TRUE)
  

• 排查依赖包本身的安装障碍
  有时候报错“dependency 'dplyr' is not available”不是你的包的问题，而是用户的环境缺少编译工具：

  • Windows用户需要安装Rtools（记得勾选“Add Rtools to system PATH”选项）
  • Mac用户需要安装Xcode命令行工具（在终端运行xcode-select --install即可）
    像dplyr这类tidyverse包包含C++代码，没有编译工具的话用户根本装不了dplyr，自然会触发依赖报错。

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