SuperAPI AI 工具集

golang-safety

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

该技能定位为“防御式 Go 工程师”规范,用于预防开发者自身失误导致的崩溃与静默数据损坏,区别于针对攻击者的安全技能。

用途:在已知类型集合时用泛型代替 any,让编译器而非运行时捕获错误;使用安全类型断言;预防 nil 相关 panic。

主要能力:

  1. nil 安全:接口只有类型与值都为 nil 才是 nil,返回带类型的 nil 指针会使接口非 nil,应显式返回 nil;写 nil map 会 panic,需先初始化或在方法中惰性初始化。
  2. 切片与 map:append 在容量允许时复用底层数组,两个切片共享内存,可用全切片表达式 a[:len(a):len(a)] 强制分配新数组;map 不可并发访问。
  3. 数值安全:整型转换会静默截断,转换前检查上下界;浮点运算不精确,使用 epsilon 比较或 math/big;整数除零会 panic。
  4. 资源安全:defer 在函数退出时运行而非每次循环,循环中应把循环体抽取为函数;关注 goroutine 泄漏。
  5. 不可变与防御性拷贝:导出函数返回切片或 map 时应返回副本。
  6. 初始化安全:设计可用的零值,用 sync.Once 做惰性初始化,避免依赖 init() 顺序。
  7. Go 1.25+ 反射中优先用 reflect.TypeAssert[T] 代替 value.Interface().(T)。
  8. 可用 errcheck、forcetypeassert、nilerr、govet、staticcheck 等 linter 自动检测。

使用方式:按上述规则编写与审查 Go 代码;可与并发、数据结构、错误处理、安全、排障、持续集成等技能交叉参考。限制:仅针对非对抗性编程错误,不覆盖攻击者视角的安全问题;部分内容依赖 Go 1.25+ 版本。