mockgen必须在module根目录运行，因依赖go list解析路径；接口须导出且不在_test.go中；需显式指定-source、-destination、-package；必须defer ctrl.Finish()校验EXPECT。
mockgen 命令必须在 module 根目录运行
mockgen 找不到接口最常见原因不是命令写错，而是当前工作目录不对。它依赖 go list 解析包路径，而 go list 只在 module 根下才能正确识别 myapp/internal/repo 这类路径。你在 internal/repo/ 目录里执行 mockgen -source=user.go，大概率静默失败或报 no interfaces found。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先确认
go.mod在哪，cd 进去再运行 mockgen - 用
go list -f '{{.Dir}}' myapp/internal/repo验证路径是否可解析 - 生成时显式指定
-destination=mocks/mock_user.go -package=mocks，避免覆盖源码或写入错误目录 - 生成完立刻执行
go build mocks/，确保 mock 文件能编译通过
接口必须导出且不能定义在 *_test.go 里
gomock 只处理首字母大写的导出接口（如 UserRepo），小写 userRepo 或未导出方法会被忽略。更隐蔽的坑是：有人把接口定义在 user_test.go 里 —— mockgen 默认不扫描 test 文件，即使加了 -source 也会跳过。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 接口定义统一放在非
_test.go的源文件中（如user_repo.go） - 检查接口是否真正可被其他包 import：
go doc myapp/internal/repo.UserRepo能显示文档才说明导出成功 - 如果必须共用测试专用接口，改用
mockgen -source=... -self_package模式，但需额外维护 package 名一致性
GoLand 里不能靠“右键 → Generate”自动调用 mockgen
GoLand 没有内置 mockgen 集成，所谓“自动生成”其实是手动配置 External Tool 或 Terminal 模板。别指望 IDE 菜单里点一下就生成好 mock —— 它不会自动推断你要 mock 哪个接口、输出到哪、包名怎么设。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在 GoLand Terminal 里固定一套命令，例如：
mockgen -source=internal/repo/user.go -destination=mocks/mock_user.go -package=mocks - 把常用命令存为 Live Template（缩写如
mg），补全路径和包名后一键执行 - 配合
//go:generate mockgen -destination=...注释 +go generate ./...，让团队共享生成逻辑，而非依赖个人 IDE 配置
gomock.Controller 必须 defer Finish()，且不能漏位置
忘记 defer ctrl.Finish() 不会编译报错，但会导致两种后果：一是 EXPECT 没被调用也不报错（测试假通过），二是某次调用没设 .Times(n) 却被多调一次，Finish() 时 panic 并提示 “expected call at … never happened”。这个 panic 往往出现在测试末尾，容易误判为环境问题。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
ctrl := gomock.NewController(t)后**立刻**跟defer ctrl.Finish()，不要换行、不要嵌套在 if 里、不要写在函数结尾 - 用 GoLand 的 Live Template 创建测试骨架，把
defer ctrl.Finish()固定在模板第二行 - 在 CI 流水线里加静态检查：grep -r "NewController" . | grep -v "defer.*Finish" —— 发现就阻断构建
ctrl.Finish() 是否真正在每个测试函数里被执行 —— 这些地方一错，测试就失去校验意义。 
