go中函数式api通过option模式解决配置爆炸与逻辑蔓延问题：用类型为func(*client)的option函数替代多参数结构体传参，实现顺序无关、可读性强、易扩展的客户端初始化。
Go 里函数式 API 不是炫技，而是解决「配置爆炸」和「逻辑蔓延」的实用手段。它让调用方一眼看清做了什么，而不是在一堆 EnableXxx、WithYyy 字段里猜意图。
用 Option 函数替代结构体字段传参
当一个初始化函数开始接受 4 个以上参数，尤其混着 bool、time.Duration、func() 时，调用点极易出错——顺序错、漏传、默认值不明确。
- 别写
NewClient(timeout time.Duration, retry bool, logger Logger, debug bool)，参数顺序难记，新增字段就得改签名 - 改用
Option类型：定义type Option func(*Client)，每个配置项封装成独立函数，如WithTimeout(5 * time.Second)、WithRetry(3) - 构造时自由组合：
NewClient(WithTimeout(t), WithLogger(l))，顺序无关，可读性强，新增配置只需加一个函数，不碰老代码 - 注意：
Option函数内部应做防御性检查，比如WithTimeout需拒绝
func(*gorm.DB) *gorm.DB 是查询条件的自然表达
DAO 层写一堆 GetByStatus、GetByCreatedAtRange 方法，本质是把 SQL 拼接逻辑硬编码进分支里，字段一变就崩。
- 统一入口只接收一个
func(*gorm.DB) *gorm.DB参数，比如FindUsers(ctx, func(db *gorm.DB) *gorm.DB { return db.Where("status = ?", 1) }) - 每个条件单独封装：
ByStatus(status int)返回闭包，ByCreatedAt(from, to time.Time)同理，复用率高且测试友好 - 组合时用
db.Scopes(opts...)或链式调用，支持 AND/OR 任意嵌套，比拼字符串安全得多 - 坑点：闭包捕获的变量（如
status）若来自循环变量，需显式拷贝，否则所有闭包引用同一地址
回调函数不是“塞个 func()”就完事
把 OnSuccess、OnFailure 当成开关字段塞进结构体，实际掩盖了控制流意图；而裸传匿名函数又容易失控。
- 明确回调契约：规定是否同步执行、是否允许 panic、是否需要返回值（如
func(error) error用于错误重试决策） - 避免裸传
func()，优先定义类型别名，如type OnRetry func(attempt int, err error) bool，提升文档性和 IDE 支持 - 调用前做 nil check：
if o.onRetry != nil && o.onRetry(attempt, err) { ... }，别让 panic 泄露到上层 - 闭包里捕获的上下文（如
ctx、log）要确认生命周期——若回调被异步保存，需确保捕获对象不会提前释放
函数式 API 的复杂点不在语法，而在契约设计：每个函数该做什么、不该做什么、失败时怎么表现，必须清晰。否则只是把结构体膨胀换成了函数列表膨胀。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
