R包开发：devtools::document()报Roxygen @name缺失错误求助

错误信息 #

> devtools::document()
ℹ Updating PCRA documentation
ℹ Loading PCRA
✖ cusumActMgr.R:104: Block must have a @name.
ℹ Either document an existing object or manually specify with @name

报错原因 #

错误指向代码第104行，核心问题是：你写了完整的Roxygen注释块，但没有定义对应的cusumActMgr函数。Roxygen要求注释块必须和一个具体的对象（函数、数据等）绑定，当前只有注释块没有匹配的函数，被识别为无归属的注释块，因此要求必须用@name指定名称，或者关联到已存在的对象。

另外，脚本里直接用library()加载依赖的写法不符合R包开发规范，但这不是本次报错的直接原因。

解决方法 #

1. 添加cusumActMgr函数定义
   在@export标签之后、加载库的代码之前，补充函数的框架（后续填充具体逻辑）：

cusumActMgr <- function(portfolioName, benchmarkName, return_df, upper_IR = 0.5, lower_IR = 0, lambda_in = 0.9, lambda_out = 0.8, winsorize = 4, filterStd = FALSE) {
  # 函数具体逻辑代码写在这里
}

添加后，Roxygen会自动将注释块与该函数绑定，无需额外指定@name。

2. 修正包依赖的加载方式
   不要在R脚本中用library()加载依赖，应该：

• 在包的DESCRIPTION文件中，将依赖包添加到Imports字段（比如Imports: xts, zoo, scales, RobStatTM, ggpubr, lemon, gridExtra, ggplot2, dplyr）
• 在需要调用依赖包函数时，使用::前缀（比如xts::as.xts()），或者在注释块中添加#' @import xts这类标签批量导入（不推荐，容易引发命名冲突）

3. 清理未完成的注释内容
   @details中的\subsection{Data Processing}没有后续内容，建议补充完整或删除该小节，避免文档生成时出现无效内容。

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