Go Structs & Interfaces · 设计小接口、组合关系与接收者

@public/golang-structs-interfaces

查看空间 →

围绕 Go 结构体和接口设计,检查消费方需要的契约、方法集、嵌入与具名字段、类型断言、接收者及序列化标签。结合零值可用性和复制语义,选择与实际依赖及兼容要求相符的类型边界。采用 MIT 许可证。

能力与使用条件

适用场景

  • 梳理消费方需要的小接口与依赖边界
  • 比较嵌入和具名字段、指针与值接收者
  • 检查字段标签、方法集及含锁类型的复制风险

输入要求

  • Go 类型定义、使用方及接口实现
  • 序列化契约、变更范围和 Go 工具链版本

输出结果

  • 类型与接口设计的取舍说明
  • 具体方法集、标签或复制问题及验证建议

前置条件

  • 读取使用方、嵌入类型和既有公开契约,具备适用 Go 工具链
  • 结合编译期接口检查、go vet 和项目测试,在容器中验证修改

不适用场景与限制

  • 接口方法数、返回具体类型与接收者一致性是设计建议,不应替代已有多态需求或兼容契约
  • 含锁类型首次使用后复制需特别审查;含 channel 或指针的结构体并非一律不可复制,应根据所有权和字段语义判断
  • 字段标签行为取决于编码器及版本;noCopy 与静态检查不是运行时禁止复制,也不能代替并发与序列化验证
  • 下载链接为固定提交的完整仓库快照,使用其中 skills/golang-structs-interfaces 目录。配图是说明性示例。

说明性示例

  • 检查这个 Go 服务的消费方接口、方法集和 JSON 字段契约,说明是否需要嵌入或具名字段;保留已有 API 并验证含锁类型未被错误复制。

资料依据

  • https://github.com/samber/cc-skills-golang/blob/d68d80aec298e1b74b37c2a472c002b5217248b3/skills/golang-structs-interfaces/SKILL.md
  • https://github.com/samber/cc-skills-golang/blob/d68d80aec298e1b74b37c2a472c002b5217248b3/LICENSE

外部资源

内容由外部网站提供,平台不保证第三方文件的完整性、可用性或安全性。

外部文件的访问权限由第三方管理,本站无法限制其地址的访问。