GoLand中mockgen配置需手动指定路径并验证版本；-source参数须指向含导出接口的非_test.go文件；Generate Test不支持mock生成，需配External Tool；测试中必须defer ctrl.Finish()且EXPECT()需在调用前声明。
GoLand里装不了mockgen？先确认go install路径
GoLand本身不内置mock工具，它依赖你本地安装的mockgen。如果在终端能跑mockgen -version，但在GoLand里执行Generate Test时提示“command not found”，大概率是GoLand没读到你的$HOME/go/bin（Go 1.21+默认）或$GOPATH/bin。
解决方法很简单：打开GoLand → Preferences → Go → GOROOT & GOPATH → 在“Go tools”页签下，手动把mockgen路径填进去。路径就是你在终端里运行which mockgen返回的结果。别指望它自动发现——GoLand不会扫描$PATH所有目录。
- 用
go install github.com/golang/mock/mockgen@latest安装，不是go get - 装完立刻在终端验证：
mockgen -version输出必须是v1.6.0或更高 - 如果用的是SDK管理器（如gvm、asdf），确保GoLand用的是同一个Go版本
mockgen命令总生成空文件？检查-source参数是否指向接口定义
mockgen -source=xxx.go这个命令看似简单，但90%的“生成失败”都卡在这儿：它只认含export接口（首字母大写）的.go源文件，且该文件不能是_test.go，也不能放在internal/下没加-self_package。
典型错误场景：
立即学习“go语言免费学习笔记（深入）”；
-
mockgen -source=repo/→ 错，-source不支持目录 -
mockgen -source=user_test.go→ 错，测试文件里的接口不被识别 -
mockgen -source=internal/user/repo.go→ 错，internal包默认被跳过，得加-self_package=myapp/internal/user
正确做法：在模块根目录运行，显式指定路径和包名：
mockgen -source=internal/user/repo.go -destination=mocks/mock_repo.go -package=mocks -self_package=myapp/internal/user
生成后立刻go build mocks/验证是否可编译——这是最省时间的自检方式。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
GoLand里右键Generate Test，为什么没弹出mock选项？
GoLand的“Generate Test”功能（Alt+Insert）默认只生成func TestXxx骨架，它不集成gomock逻辑。想一键生成mock代码，你得自己配External Tool：
- Preferences → Tools → External Tools → +号添加
- Name填
mockgen，Program填mockgen完整路径 - Arguments填：
-source=$FilePath$ -destination=$ProjectFileDir$/mocks/mock_$FileNameWithoutExtension$.go -package=mocks - Working directory设为
$ProjectFileDir$
配好后，选中一个含接口的.go文件，右键 → External Tools → mockgen，就能直接生成。注意：这个命令只对当前文件生效，且要求该文件里有且仅有一个导出接口（否则mockgen会报错）。
测试里调用mock对象却panic：Unexpected call？别漏defer ctrl.Finish()
gomock是“预期驱动”的，不是写了EXPECT()就完事了。每个测试函数里，ctrl.Finish()必须出现在NewController(t)之后、任何mock调用之前，且必须用defer——这是硬性要求，不是建议。
漏掉它的后果很隐蔽：
- 测试可能通过，但实际没校验任何调用是否发生
- 如果mock方法被调用了2次，而你只声明了1次
EXPECT()，Finish()会在测试结束时panic并报“expected call at … never happened”
正确模板只有这一种写法：
ctrl := gomock.NewController(t)
defer ctrl.Finish() // 这行必须紧接在NewController后面
mockRepo := mocks.NewMockUserRepo(ctrl)
mockRepo.EXPECT().GetUserByID(gomock.Eq(123)).Return(&User{Name: "foo"}, nil)
还有个易错点：Return()参数顺序和类型必须和接口方法签名完全一致。比如接口返回(int, error)，你就得写.Return(42, nil)，不能只写.Return(42)——Go不支持忽略返回值。
gomock真正的复杂点不在生成，而在校验逻辑的确定性：它把“是否调用”“调用几次”“参数是否匹配”全绑定在Finish()那一刻。一旦忘记defer，或者EXPECT()写在mock调用之后，整个测试就失去断言意义。这不是bug，是设计使然。
