使用Roxygen2记录数据集报错：'errorCodes'非包命名空间导出对象

以下是针对问题的具体解决步骤：

• 编写正确的数据集Roxygen2注释
  创建单独的文档化文件（比如R/data-docs.R），为errorCodes编写规范注释，不要添加@export标签——数据集通过LazyData机制加载，无需通过命名空间导出：

  #' 包内错误码映射数据集
  #'
  #' 存储所有函数使用的错误码及其对应说明的数据集
  #'
  #' @format 请根据实际类型描述：例如一个包含`code`（错误码）和`message`（提示信息）列的数据框
  #' @keywords datasets
  "errorCodes"
  

  注释最后一行必须是带引号的变量名，不能用NULL替代，否则roxygen2无法识别这是数据集的文档注释。

• 确认DESCRIPTION配置
  检查DESCRIPTION文件中的LazyData设置必须是LazyData: TRUE（注意TRUE要大写），确保无拼写错误。

• 重新生成包文档与命名空间
  执行完整的roxygenize命令（不要仅指定vignette roclet），让roxygen2重新生成命名空间和文档：

  roxygen2::roxygenize('.')
  

  如果之前的NAMESPACE文件有残留问题，可先备份后删除，再执行上述命令生成干净的命名空间文件。

• 验证函数调用与包加载
  包内函数调用errorCodes时直接使用变量名即可，无需加IAPWS95::前缀。测试流程：

  1. 卸载已加载的包：detach("package:IAPWS95", unload = TRUE)
  2. 重新安装包：devtools::install()
  3. 加载包并调用依赖errorCodes的函数，确认能正常访问该数据集。

• 排查潜在冲突

  • 确保R/data/errorCodes.rda文件正确保存，变量名与文件名一致（保存时使用save(errorCodes, file = "R/data/errorCodes.rda")）。
  • 检查包内其他R文件是否重复定义了errorCodes变量，避免命名冲突。

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