用途:面向 Go 架构的惯用模式技能,用于设计新 API、包与项目结构,或审查既有代码中的设计问题。仅在实际问题存在时应用模式,反对过早抽象。
主要能力:围绕函数式选项构造器、init() 与全局状态规避、枚举起始值、panic 与 error 取舍、资源管理与限流等给出规则;并引用同系列技能处理错误处理、context、structs/interfaces、数据库、项目布局等主题。
两种模式:设计模式在提出方案前先询问开发者架构偏好,选择满足需求的最小模式;审查模式扫描 init() 滥用、无界资源、缺少超时和隐式全局状态,先报告再建议重构。
关键规则:构造器宜用函数式选项,校验可失败时必须返回 error;避免 init(),改用显式构造器;枚举从 1 开始或用 0 作未知哨兵;错误分支优先返回以保持主路径扁平;panic 仅用于 bug;打开资源后立即 defer Close();优先 runtime.AddCleanup 而非 SetFinalizer;每次外部调用设置超时;限制池、队列、缓冲区大小;重试需检查 context 取消;正则包级编译一次;用 //go:embed 嵌入静态资源;编译期接口断言。
用法:可作为公司技能被显式覆盖;需先了解架构偏好再提模式。限制:官方未提供价格、平台与其他资源消耗等说明。