用途:把“要失败就尽早、尽量响亮、尽量带上下文地失败”落成规范,用于编写或审查接收外部输入的函数与模块,为包函数添加输入校验,重构静默产生错误结果的代码,审查拉取请求的错误处理质量,以及加固内部 API 对非法参数的防护。
主要能力与用法:先识别信任边界,即公共 API 函数、面向用户的参数、文件 I/O、网络响应、环境变量等外部数据入口;内部辅助函数一般无需重复校验。随后在每个公共函数开头加入守卫子句,做类型检查、非空检查、参数匹配和范围检查,全部通过后再开始实际计算。错误信息需回答四点:什么失败、在哪里失败、为什么(期望值与实际值)、如何修复。资料给出 R 基础写法与 rlang/cli 写法,以及 TypeScript 示例。
判断标准:当函数无法产生正确结果时应使用 stop() 或 cli::cli_abort();仅当结果仍可用但调用方需知情时才用 warning()。内部不变量可用 stopifnot() 或显式断言,让缺陷在违反点立即暴露。需要重构的反模式包括:吞掉错误的空 tryCatch、用默认值掩盖非法输入、以 suppressWarnings 代替校验、笼统的捕获所有异常处理器。
验证与限制:改造后应运行测试套件,并用 expect_error 覆盖各错误路径、expect_no_error 确认合法输入仍可用;如已有测试依赖静默失败,需更新为预期报错。常见陷阱包括验证过深(在内部辅助函数重复校验)、错误信息缺少上下文、该 stop 却用 warning、忘记 call. = FALSE(R 中面向用户的函数)、把校验放在测试而非代码中。混合系统上 Rscript 可能指向跨平台包装脚本,可用 which Rscript && Rscript --version 检查并优先使用原生二进制。资料未提供该技能的收费、价格、平台或效果信息。