SuperAPI AI 工具集

go-defensive

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:在 Go 代码的 API 边界进行防御性加固,降低调用方与被调用方之间的数据泄漏、资源未释放与不安全随机数等风险。

主要能力与检查顺序:1. 错误处理,返回 error 而非 panic;2. 输入校验,拷贝从调用方接收的 slice/map;3. 输出安全,返回前拷贝 slice/map;4. 资源清理,对 Close/Unlock/Cancel 使用 defer;5. 接口检查,编译期断言交由 go-interfaces;6. 时间正确性,使用 time.Time 与 time.Duration 而非 int/float;7. 枚举安全,iota 从 1 开始使零值无效;8. 加密安全,密钥用 crypto/rand,禁用 math/rand。

必要用法:接收时用 make+copy 复制传入 slice;返回前复制 map;在 os.Open 后立即写 defer f.Close();defer 参数在 defer 执行时求值,多个 defer 按 LIFO 执行。枚举示例:iota + 1 使 Add=1、零值表示未初始化,零值合理时可例外。序列化结构体应显式添加字段标签,标签属于序列化契约。避免可变全局量,改为依赖注入,例如注入 now func() time.Time 便于测试。生成密钥时 import "crypto/rand",文本输出用 rand.Text()。panic 仅用于不可恢复情况,库函数应避免 panic,不得跨包暴露 panic,须转为 error;recover 可用于隔离服务器 goroutine 中的 panic。Must 函数仅在初始化阶段使用,失败即程序无法运行。

适用场景:处理跨 API 边界的数据拷贝、资源释放、时间与枚举类型、序列化标签、密钥随机数及 panic 边界隔离。

限制:加密示例中的 crypto/rand.Text 需要 Go 1.24+。接口断言的具体写法归 go-interfaces 技能负责,本技能仅用于识别边界健壮性风险。其余参考资料如 GLOBAL-STATE、MUST-FUNCTIONS、PANIC-RECOVER、TIME-ENUMS-TAGS 的具体内容未在给定资料中完整提供。