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
外部资源
内容由外部网站提供,平台不保证第三方文件的完整性、可用性或安全性。
外部文件的访问权限由第三方管理,本站无法限制其地址的访问。