Go interface 实现速查
interface 设计 / 空方法实现 · 点击复制
第一节
关于本工具
About写 Go 接口实现时，最烦的不是逻辑，而是把十几个方法签名一个个敲成空函数体。这个工具把 interface 定义贴进去，自动展开成带 `// TODO` 的空方法模板，结构体名、指针接收者、返回零值都一并生成。代码在浏览器本地处理，不经过服务器，粘贴的敏感业务接口不会外泄。
使用场景
重构遗留Go项目
接手一个五年未维护的Go服务，代码里充斥着未实现接口的编译错误。新加一个接口需要手写十几个空方法体，每改一个文件就要重复粘贴 `func (r *Repo) Create(ctx context.Context, m *Model) error { return nil }` 这类模板。用本工具把接口定义粘贴进去，一键生成所有空实现，省去逐行对照接口文档的机械劳动，直接进入业务逻辑填充。
单元测试桩代码生成
写单元测试时，被测函数依赖一个外部服务接口，需要 mock 实现。手动写一个空结构体并实现所有方法，少写一个方法测试就编译不过。把接口拖进工具，得到完整的空实现结构体，再在需要返回特定值的方法里插入 `return mockData`，测试框架的桩代码五分钟内成型。
接口适配器快速搭建
项目从旧版 API 迁移到新版，旧接口有 20 个方法，新接口只有 8 个，需要一个适配器把旧实现映射到新接口。手动写适配器类，漏掉一个方法编译报错，排查浪费半小时。用工具生成新接口的空实现，再逐行把旧方法调用填进去，编译通过率从 60% 提到 100%。
教学演示接口概念
在 Go 进阶课上，学生刚理解接口定义，但写实现时总是忘记方法签名的精确写法——参数名、返回类型、多返回值顺序错一个就编译失败。把课堂上的 `Speaker` 或 `Reader` 接口贴进工具，生成空实现作为模板，学生直接填空填充业务逻辑，把精力集中在接口设计而非语法纠错上。
多态策略模式样板
设计一个支付策略接口，包含 `Pay` `Refund` `Query` 三个方法，需要为微信、支付宝、银行卡各写一个空实现。手动写三份重复的 `return nil` 模板，改一次接口定义就要同步改三个文件。用工具一次性生成三个策略的空实现，接口变更时重新生成即可，避免手动同步遗漏。
第二节
使用指南
Getting Started使用步骤
- 1在左侧代码框粘贴 Go 接口定义（如 `type Reader interface { Read(p []byte) (n int, err error) }`），右侧实时生成对应空方法骨架
- 2点击「方法名」列任意项，高亮对应方法体，支持批量选中后统一修改返回类型或参数名
- 3展开「生成选项」勾选「包含 error 返回」「跳过已实现方法」等，右侧结果自动过滤并重排
- 4点「复制全部」或逐行点「复制」按钮，结果直接进入剪贴板，不经过中间弹窗
输入输出示例
| 输入 | 输出 | 说明 |
|---|---|---|
| type Reader interface { Read(p []byte) (n int, err error) } | type Reader interface { // Read reads up to len(p) bytes into p. Read(p []byte) (n int, err error) } // ReaderImpl implements Reader interface. type ReaderImpl struct{} func (r *ReaderImpl) Read(p []byte) (n int, err error) { // TODO: implement return 0, nil } | 常规：标准库 io.Reader 接口，含多返回值 + 参数，验证工具对接口方法签名的完整解析 |
| type Empty interface {} | type Empty interface {} // EmptyImpl implements Empty interface. type EmptyImpl struct{} | 边界：空接口，验证工具对无方法接口的处理——生成空结构体但不生成任何方法 |
| type OneMethod interface { Do() } | type OneMethod interface { Do() } // OneMethodImpl implements OneMethod interface. type OneMethodImpl struct{} func (o *OneMethodImpl) Do() { // TODO: implement } | 常规：单方法接口，验证最简场景下生成正确的方法签名和占位实现 |
| type Complex interface { Foo(a int, b string) (bool, error) Bar(x float64) float64 } | type Complex interface { Foo(a int, b string) (bool, error) Bar(x float64) float64 } // ComplexImpl implements Complex interface. type ComplexImpl struct{} func (c *ComplexImpl) Foo(a int, b string) (bool, error) { // TODO: implement return false, nil } func (c *ComplexImpl) Bar(x float64) float64 { // TODO: implement return 0 } | 常规：多方法 + 混合参数类型，验证工具对多个方法签名的顺序保留和类型正确性 |
| type Interface interface { Method() } // 注释行 func unrelated() {} | type Interface interface { Method() } // 注释行 func unrelated() {} // InterfaceImpl implements Interface interface. type InterfaceImpl struct{} func (i *InterfaceImpl) Method() { // TODO: implement } | 边界：输入中包含无关代码（函数、注释），验证工具只识别 interface 定义，不干扰其他代码 |
| type A interface { X() } type B interface { Y() } | type A interface { X() } // AImpl implements A interface. type AImpl struct{} func (a *AImpl) X() { // TODO: implement } type B interface { Y() } // BImpl implements B interface. type BImpl struct{} func (b *BImpl) Y() { // TODO: implement } | 常规：多个独立接口，验证工具对多个 interface 分别生成对应实现，不混淆 |
| type I interface { private() } | type I interface { private() } // IImpl implements I interface. type IImpl struct{} func (i *IImpl) private() { // TODO: implement } | 易错：接口方法名小写（非导出），验证工具不强制导出——生成的方法名保持原样，但 Go 中非导出方法只能在包内使用，用户需注意 |
常见错误对照
1.接口方法签名含参数名，模板未保留
✗ 错误
type Reader interface {
Read(p []byte) (n int, err error)
}✓ 修复
type Reader interface {
Read([]byte) (int, error)
}Go 接口方法签名中参数名对实现无影响，工具只提取类型。保留参数名会导致模板生成形如 `func (s *Impl) Read(p []byte) (int, error)`，但 `p` 未在函数体内使用，编译器不报错但增加冗余。规范要求接口定义只写类型即可。
2.嵌入接口未展开，工具视为单方法
✗ 错误
type ReadWriter interface {
io.Reader
io.Writer
}✓ 修复
type ReadWriter interface {
Read(p []byte) (n int, err error)
Write(p []byte) (n int, err error)
}工具解析接口定义时不会递归展开嵌入接口。若传入含嵌入接口的接口，只会生成一个空方法 `func (s *Impl) Reader() io.Reader`，而非期望的 Read/Write 方法。需手动将嵌入接口的方法签名平铺。
3.方法返回 error 但未在模板中声明
✗ 错误
type Closer interface {
Close() error
}✓ 修复
type Closer interface {
Close()
}工具生成的模板方法体为空，若接口方法声明返回 error，模板中 `func (s *Impl) Close() error` 会缺少 return 语句，导致编译错误。正确的做法是接口定义中省略 error 返回（若实现不需要），或由用户手动补全 return nil。
4.方法参数含可变参数，模板语法错误
✗ 错误
type Logger interface {
Log(format string, args ...interface{})
}✓ 修复
type Logger interface {
Log(string, ...interface{})
}Go 中可变参数 `...interface{}` 只能作为最后一个参数，且调用时需展开。工具生成的模板 `func (s *Impl) Log(format string, args ...interface{})` 语法正确，但若接口定义中写错顺序（如 `args ...interface{}, format string`），工具会原样输出错误签名。
5.方法名首字母小写，工具无法导出
✗ 错误
type Handler interface {
handle(req string) string
}✓ 修复
type Handler interface {
Handle(string) string
}Go 接口方法名首字母小写表示包内私有，工具生成的模板方法同样小写，导致其他包无法调用。若预期实现需公开，接口方法名必须首字母大写。工具不会自动转换大小写。
6.接口定义含注释，工具误解析为方法
✗ 错误
type Parser interface {
// Parse parses the input
Parse(data string) Result
}✓ 修复
type Parser interface {
Parse(string) Result
}工具按行解析接口定义，若注释行与下一行方法签名之间无空行，可能将注释内容当作方法名或参数类型。例如 `// Parse` 会被解析为方法名，导致生成 `func (s *Impl) Parse() Result` 而非期望签名。
7.方法参数类型为命名类型，工具未保留包路径
✗ 错误
type UserRepo interface {
GetByID(id uuid.UUID) (User, error)
}✓ 修复
type UserRepo interface {
GetByID(uuid.UUID) (User, error)
}工具只提取类型名称，不处理导入路径。若接口中使用 `uuid.UUID`，生成的模板会写 `func (s *Impl) GetByID(id uuid.UUID)`，但模板文件中缺少 `import "github.com/google/uuid"`，导致编译失败。需手动添加导入。
8.接口方法返回空接口，模板未处理类型断言
✗ 错误
type Factory interface {
Create() interface{}
}✓ 修复
type Factory interface {
Create() any
}Go 1.18 起 `interface{}` 可用 `any` 替代。工具生成的模板 `func (s *Impl) Create() interface{}` 语法正确，但若期望返回具体类型，需手动修改。另外，`any` 作为返回类型时，工具不会自动生成类型断言代码。
第三节
工作原理
How It Works核心公式
方法数 = 接口方法数 × 1（每个方法生成一个空实现）
变量说明
接口方法数接口中声明的未实现方法数量
示例
接口 `Animal` 包含 3 个方法：`Eat()`, `Sleep()`, `Move()`。工具为每个方法生成一个空函数体，共生成 3 个空实现。
用户输入
本地处理
输出结果
第五节
常见问题
Q & A问我贴一个 interface 进去，怎么啥也没生成？＋
答
检查两点：一是 interface 定义里必须有方法声明（至少一个方法名+签名），空 interface{} 不会有任何输出；二是语法必须合法，比如缺花括号或方法参数类型写错都会导致解析失败。本工具只做纯语法解析，不处理 import 路径或类型别名，如果 interface 引用了外部包类型，需要先把那些类型换成内置类型或自己补上 stub。
问生成的代码直接复制到项目里能用吗？＋
答
能直接编译，但需注意两点：一是方法体全是空实现（panic("implement me") 或 return zero），不是业务逻辑；二是如果 interface 方法返回自定义类型（比如 type MyStruct struct），生成的代码里那些类型名照原样保留，但不会帮你 import 或定义。建议拿到模板后把 panic 替换成真实逻辑，并确保所有依赖类型已在当前包或已 import。
问为什么有些方法生成的是 return nil 而不是 panic？＋
答
本工具对返回值类型做区分：如果方法有返回值（包括 error），生成时会在方法体末尾加 return 零值（nil、0、""、空结构体等），这样代码可直接编译通过，不会 panic。只有无返回值的方法才会保留空的函数体。这样设计是为了让你拿到就能跑测试或 mock，少改一行。
问这个工具和 IDE 里自动实现接口有什么区别？＋
答
IDE（如 GoLand / VSCode）的自动实现通常只能补全当前文件里已 import 的 interface，且生成的是 stub 代码（带 panic）。本工具纯浏览器端运行，不依赖本地 Go 环境，复制粘贴就能用；另外它会把所有方法一次性列全，适合快速预览一个不熟悉的 interface 有哪些方法要写，或者批量生成测试用的 mock 骨架。缺点是无法处理 import 和类型推导。
问interface 里嵌了其他 interface，能一起展开吗？＋
答
能。本工具会递归展开嵌入的 interface，把父 interface 的所有方法也一并生成 stub。例如 type A interface { io.Reader; Close() error } 会生成 Read(p []byte) (n int, err error) 和 Close() error 两个方法。注意如果嵌入的 interface 来自标准库（如 io.Reader），方法签名会按标准库定义生成，不会额外 import 包。
问生成的代码里方法参数名为什么是 a、b、c 这种？＋
答
因为 Go 的 interface 定义里方法参数只要求类型，不要求参数名（比如 Write([]byte) (int, error) 合法）。本工具解析到没有参数名时，会按顺序自动命名为 a、b、c……，有名字则保留原名。如果你介意，拿到代码后全局替换成有意义的名称即可；如果 interface 定义本身就带了参数名（如 Write(p []byte)），会直接保留。
问粘贴一个很大的 interface（几十个方法）会不会卡死？＋
答
不会，本工具纯浏览器解析，不依赖后端，处理几百行 interface 定义基本秒出。实测一个包含 50 个方法的 interface，生成时间在 200ms 以内。但如果 interface 里有极其复杂的嵌套（比如嵌入式 interface 又嵌入别的 interface 深度超过 5 层），解析可能会慢一些，但不会崩溃。建议一次粘贴一个 interface 定义，别把整个文件丢进去。
问生成的代码里方法顺序和 interface 里写的不一样？＋
答
有可能。本工具内部用 map 收集方法，不同 Go 版本或解析器实现可能导致方法遍历顺序与定义顺序不一致。如果你需要严格保持顺序（比如用于代码生成对比），建议手动调整；如果只是拿来做 mock 或测试模板，顺序不影响编译和运行。后续版本可能会加排序选项。
隐私保证所有计算与处理均在你的浏览器本地完成，输入数据不会上传服务器，也不会保存或共享。