使用devtools::check遇缺失字段错误,是否需添加Author/Maintainer?
你的操作能临时解决检查报错,但不符合《R Packages》推荐的最佳实践,正确的处理方式是用roxygen2自动生成所需字段,而非手动添加冗余内容。
报错原因
Author@R是结构化的作者信息字段,本身符合规范,但R的包检查工具默认需要显式的Author和Maintainer字段——这两个字段本应通过roxygen2读取Author@R自动生成,你跳过了文档生成步骤直接运行检查,因此触发错误。
正确解决步骤
- 确保已安装roxygen2:
install.packages("roxygen2") - 在包根目录(
minimal文件夹)的R会话中执行:
该命令会读取devtools::document()Author@R的配置,自动在DESCRIPTION中生成标准的Author和Maintainer字段,同时生成add()函数的帮助文档。 - 再次运行
devtools::check(),字段缺失的错误就会消失。
不推荐手动添加的理由
Author@R通过person()函数定义作者信息,支持多作者、区分角色(如aut=作者,cre=维护者,ctb=贡献者),结构清晰规范。手动添加Author和Maintainer会造成信息冗余,后续作者信息变更时需同时修改三处内容,容易出错。
内容的提问来源于stack exchange,提问作者ipofanes
相关产品推荐
相关产品推荐

