构建自定义R包时loadNamespace报错：找不到maptools包（已替换依赖）

我有一个已使用多年的本地自定义R包，原本部分函数依赖即将停止维护的rgdal、sp、maptools包，现已将这些函数修改为依赖sf和terra包。但使用R-Studio和RTools43构建该包时，却出现如下loadNamespace错误：

Error in loadNamespace(j <- i[[1L]], c(lib.loc, .libPaths()), versionCheck = vI[[j]]) : 
     there is no package called 'maptools'

已搜索包目录内所有文件，未发现任何依赖maptools的内容，且因该包即将终止支持，不想安装它。DESCRIPTION文件中的IMPORTS列表如下：

IMPORTS:
  xts,
  magrittr,
  R.utils,
  parallel,
  pbapply,
  terra,
  tools,
  data.table,
  hydroGOF,
  sf,
  plyr,
  raster,
  dygraphs,
  htmltools

排查解决思路 #

• 检查间接依赖：直接依赖的包可能间接依赖maptools。运行以下命令查看依赖链：

  tools::package_dependencies(
    packages = c("xts", "magrittr", "R.utils", "pbapply", "terra", "data.table", "hydroGOF", "sf", "plyr", "raster", "dygraphs", "htmltools"),
    recursive = TRUE
  )
  

  若发现某个依赖包依赖maptools，尝试将其更新到最新版本，新版本通常已移除对maptools的依赖。

• 清理构建缓存：残留的缓存可能保留旧依赖记录。执行以下操作：

  • 删除包目录下src/文件夹中的.o、.so（Windows为.dll）文件
  • 若NAMESPACE是自动生成的，删除该文件后重新运行devtools::document()
  • 在RStudio中点击Tools -> Project Options -> Build Tools -> Clean All，或运行devtools::clean()

• 核查NAMESPACE文件：

  • 手动编写的NAMESPACE需检查是否残留import(maptools)或importFrom(maptools, ...)语句
  • 自动生成的NAMESPACE，确认DESCRIPTION中roxygen2配置正确，重新生成文件

• 全局搜索隐藏调用：用RStudio的Ctrl+Shift+F搜索整个包目录下的maptools关键词，包括R脚本、注释、条件分支（如if(...) {require(maptools)}）、Rmd/Rnw文件等，确认无遗漏的调用语句。

• 检查数据文件依赖：若包内包含RData/RDS格式的数据文件，可能是用maptools创建的，加载时会触发依赖。重新用sf/terra生成这些数据文件，替换旧文件。

• 干净环境构建：重启RStudio，在未加载任何额外包的干净会话中，运行devtools::install()重新构建包，避免其他包的干扰。

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