SuperAPI AI 工具集

golang-structs-interfaces

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

用途:这是一份面向 Go 类型系统设计的技能文档,指导如何设计结构体与接口,目标是可测试性与清晰性,而非为抽象而抽象。

主要能力与原则:接口应保持 1-3 个方法,大接口由小接口组合而成;接口必须定义在消费方而非实现方;函数应接受接口参数、返回具体类型;不要过早创建接口,先写具体类型,等第二个实现或测试替身出现再抽取;让零值可用,避免必须构造才能使用;能用泛型时优先于 any,仅在 JSON 解码、反射等真正未知类型的边界使用 any。

标准库接口:列出 io.Reader、io.Writer、io.Closer、fmt.Stringer、error、net/http.Handler、encoding/json 的 Marshaler 与 Unmarshaler 及其规范方法签名,要求遵守规范命名,不要自造 ToString() 或 ReadData()。可用 var _ io.ReadWriter = (*MyBuffer)(nil) 在编译期校验接口实现。

类型断言与切换:断言必须使用逗号-ok 形式,单值形式在类型不匹配时会 panic;类型切换用于按动态类型分派,也可断言到小的可选接口以利用更丰富的实现。

嵌入与依赖注入:结构体嵌入提升内部类型的方法与字段,属于组合而非继承;需要暴露完整 API 时用嵌入,仅内部使用时用命名字段。构造函数接受接口依赖,便于解耦与测试。

结构体标签与接收者:被序列化的导出字段必须有字段标签,否则编码器回退到 Go 字段名,重命名会静默改变线格式;指针接收者用于修改接收者、含 sync.Mutex、大结构体,值接收者用于小且不可变、基本类型、只读访问器,同一类型的所有方法接收者必须一致。含互斥锁、channel 或内部指针的结构体复制会破坏不变量,可嵌入 noCopy 哨兵,用 go vet ./... 的 copylocks 诊断,并按指针传递。

限制:资料未提供该技能的安装命令、收费方式、平台支持或具体使用步骤,暂未提供。文档为社区默认技能,若公司技能显式取代则以公司技能优先。