如何在R包中解析子目录，实现R/目录文件拆分？

默认情况下，R的包构建工具（包括R CMD INSTALL和devtools::install()）不会递归遍历R/目录下的子文件夹，子目录里的R文件因此不会被加载或打包。以下是几种可行的解决办法：

• 本地开发时临时加载子目录
  若仅在本地调试，不想修改包结构，可使用devtools::load_all()的recursive参数：

  devtools::load_all(recursive = TRUE)
  

  该命令会递归读取R/下所有子目录的R文件，方便本地测试。

• 手动配置DESCRIPTION的Collate字段
  在包的DESCRIPTION文件中添加Collate字段，明确列出所有需要加载的R文件路径（包括子目录内的），示例：

  Collate:
      'utils/helper_functions.R'
      'models/linear_regression.R'
      'main.R'
  

  这种方式需手动维护文件列表，适合结构相对稳定的包。

• 用roxygen2自动生成Collate
  若用roxygen2管理文档，可在主文件中通过@include标签引用子目录的文件，比如在R/main.R里添加：

  #' @include utils/helper_functions.R
  #' @include models/linear_regression.R
  NULL
  

  运行devtools::document()时，roxygen2会自动更新DESCRIPTION里的Collate字段，无需手动维护加载顺序。

• 使用pkgload包递归加载
  pkgload是devtools依赖的底层包，同样支持递归加载：

  pkgload::load_all(recursive = TRUE)
  

  效果与devtools一致，适合不想依赖devtools全部功能的场景。

注意：若要将包发布到CRAN，需确保所有子目录文件都被正确包含在Collate中，或用roxygen2自动处理，避免遗漏文件导致功能缺失。

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