Roxygen中是否存在参数类型的标准语法？

好问题！其实Roxygen（尤其是现在主流的Roxygen2版本）早就支持参数类型的标准化标注了，只是写法和你提到的PHPDoc、Sphinx略有不同，社区里已经形成了几种通用的实践方式，我给你详细梳理下：

1. 官方推荐的结构化类型标注 #

Roxygen2支持用大括号包裹类型的写法，把类型信息直接放在参数名前，这种写法会被工具直接解析，生成的文档里会清晰展示类型，甚至RStudio这类IDE还会识别它做代码提示。示例如下：

#' 计算向量的加权平均值
#' @param {numeric} vec 待计算的数值向量
#' @param {numeric} weights 与vec长度匹配的权重向量（可选，默认全为1）
#' @return 加权平均值
weighted_mean <- function(vec, weights = rep(1, length(vec))) {
  sum(vec * weights) / sum(weights)
}

你也可以把类型放在参数描述的开头，用冒号分隔，这也是官方认可的写法：

#' @param vec numeric: 待计算的数值向量

2. Tidyverse风格的标注实践 #

如果你在开发Tidyverse生态的包，他们的风格指南现在也兼容上面的结构化写法，早期的推荐是在描述开头明确说明类型，比如：

#' @param n 整数：用于指定抽样的次数

不过现在越来越多Tidyverse包转向大括号的结构化标注，因为它更机器友好，方便后续的文档自动化处理。

3. 兼容旧版本的兼容性写法 #

如果你的代码需要兼容较老的Roxygen版本（比如Roxygen1），可以直接在参数描述的开头用英文明确类型，这是早期风格指南的标准要求，兼容性拉满：

#' @param n An integer specifying the number of iterations

4. 结合类型检查的进阶实践 #

如果你想让类型标注不只是文档用，还能落地到代码逻辑里，可以配合checkmate或assertthat这类包做参数类型校验，让文档和代码逻辑保持一致：

#' 生成指定长度的随机整数向量
#' @param {integer} length 向量的长度（必须大于0）
#' @param {integer} min 随机数的最小值
#' @param {integer} max 随机数的最大值
#' @return 随机整数向量
random_int_vec <- function(length, min, max) {
  checkmate::assert_integerish(length, lower = 1)
  checkmate::assert_integerish(c(min, max))
  sample(min:max, length, replace = TRUE)
}

总的来说，大括号包裹类型的写法是目前社区最主流的标准化方案，兼顾了可读性、工具支持性和未来的扩展性。

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