将NULL作为函数参数选项有何弊端？R包开发相关实践问询

这种将NULL用作功能开关的设计不属于绝对的不良实践，R生态中本身就有大量成熟的包采用类似的参数设计，对你的需求场景来说，确实能避免互斥参数的矛盾传参问题，简化调用逻辑，降低普通用户的使用成本。

但这种设计也存在几个需要注意的弊端：

• 参数语义不够直观：单独的逻辑开关（比如se = TRUE/FALSE）语义一目了然，用户看到就能立刻明白参数作用，而lev参数如果没有明确的文档说明，用户很难第一时间反应过来传入NULL是关闭置信区间的操作，新手用户容易困惑。
• 异常校验成本更高：你需要额外对参数传入的合法性做校验，比如处理用户传入非0-1的数值、字符、长度大于1的向量等异常情况，如果直接把异常值传给底层函数，报错信息会很晦涩，用户很难定位是自己传参错误还是封装的函数有问题。
• 后续扩展灵活性有限：如果后续你需要给函数新增其他和置信区间无关的控制逻辑，比如增加是否显示平滑线本身的开关，你要么需要新增独立的逻辑参数，要么就得复杂化lev的取值规则，反而会破坏原本设计的简洁性。
• 和R用户的通用使用习惯有轻微冲突：绝大多数R函数都遵循「逻辑参数控制功能是否开启，配套参数控制功能细节」的设计逻辑，长期使用R的用户已经形成了固定习惯，切换到你的单参数设计需要一定的适应成本。

如果要保留这种设计，建议你做两个优化：

1. 给lev设置符合绝大多数用户需求的默认值，比如lev = 0.95，用户不需要调整置信水平时可以直接不传参数，降低使用成本
2. 增加严格的参数校验，抛出友好的错误提示，优化后的代码示例如下：

my_smooth <- function(lev = 0.95, ...){
  # 合法性校验
  if (!is.null(lev)) {
    if (!is.numeric(lev) || length(lev) != 1 || lev < 0 || lev > 1) {
      stop("`lev`参数仅支持传入0-1之间的单个数值（作为置信水平），或传入NULL关闭置信区间展示")
    }
    return(geom_smooth(se = TRUE, level = lev, ...))
  }
  geom_smooth(se = FALSE, ...)
}

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