Agent Skills
返回列表
💻

Go 结构体与接口设计

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-golang-golang-structs-interfaces。

技能介绍

你在纠结什么

Go 里接口一写就是五个方法、Client 却在自己的包里定义 Sender,测试只能起真数据库——这类问题往往来自契约放错地方和过早抽象。本技能以「类型系统设计者」视角,把可测试性与可读性放在抽象之上,而不是为接口而接口。

技能会怎么约束你的设计

  • 接口体量:优先 1~3 个方法的小接口,大契约用组合拼出来;命名与标准库一致(如 String() 而非 ToString())。
  • 定义位置:接口必须在消费方定义;构造函数入参用接口,返回值用具体类型。
  • 演进节奏:先有 2+ 实现或明确可测需求再抽接口;能用泛型就别在业务里滥用 any。
  • 实现与校验:用 var _ io.Reader = (*T)(nil) 做编译期检查;类型断言一律 v, ok := x.(T);可选能力用 type switch / 断言探测(类似 http.Flusher)。
  • 结构体细节:嵌入 vs 命名字段、指针/值 receiver 全类型一致、序列化字段必须打 tag;含锁或通道的类型用 noCopy 并只传指针。

边界与注意点

这是设计规范与检查清单,不会替你做架构决策或生成完整项目骨架。与其它 samber Go 技能(命名、DI、设计模式、gopls 重构)有交叉引用,适合在写库、改公共 API 或补测试时按需对齐。

使用场景

  • 重构包里臃肿的五方法接口,拆成可组合的小接口并补编译期实现检查
  • 为 HTTP handler 增加可选 Flush 能力,用 type switch 探测而不改现有调用方签名
  • 新服务构造需要 UserStore,在测试里用 mock 实现接口而不用连真实数据库
  • 导出 JSON 的 struct 补全 `json`/`omitempty` 等 tag,避免序列化字段名与零值行为不一致

适合人员

  • 维护内部 Go SDK、需要统一「接受接口、返回结构体」约定的库作者
  • 负责 code review、要抓「接口定义在实现包」和裸类型断言的团队负责人
  • 为遗留服务补单元测试、想用接口注入替换硬编码数据库调用的后端工程师
  • 从 Java/C# 转 Go、需要区分嵌入与继承、指针/值 receiver 规则的应用开发者