mockgen必须指定具体.go文件而非目录或通配符；需确保接口导出、路径与-package一致、正确配置GOPATH/PATH，并在测试中调用defer ctrl.Finish()触发校验。
mockgen命令必须指向具体.go文件，不能是目录或通配符
GoLand 里点右键“Generate Mock”失败，八成是因为底层调用的 mockgen 参数错了。它不扫描包，只读单个源文件——mockgen -source=service/user.go ✅，mockgen -source=service/ ❌ 或 mockgen -source=service/*.go ❌ 都会报 no interfaces found。
实操建议：
- 确认
user.go里有导出的 interface（首字母大写），且没语法错误 - 别把
_test.go当源文件——测试文件通常不含可导出接口，mockgen会跳过 - 如果接口在
internal/下，必须加-self_package=yourmodule/internal/service，否则生成的 mock 包路径错，导入时报错
GoLand Terminal里运行mockgen要检查GOPATH和PATH
在 GoLand 的 Terminal 里敲 mockgen 报 command not found，不是插件问题，是环境没配好。GoLand 默认复用系统 shell 环境，但有时 GOPATH/bin 或 Go 1.21+ 的 $HOME/go/bin 没进 PATH。
实操建议：
- 先在终端运行
go install github.com/golang/mock/mockgen@latest - 再运行
which mockgen，看输出路径是否在$PATH里；不在就手动加：export PATH=$PATH:$HOME/go/bin - GoLand 的 Terminal 设置里可勾选 “Shell integration”，让它自动加载 shell 配置
生成的mock文件import失败？检查-package和目录名是否一致
mock 文件生成成功，但测试里 import "yourproject/mocks" 报错，常见原因是 -package 参数和实际目录名对不上。Go 要求 package 声明必须和目录名完全一致，大小写都不能差。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
实操建议：
- 先建好
mocks/目录（mockgen不自动创建父目录） - 生成时明确指定
-package=mocks，且确保mocks/下没有go.mod或其他非mock_*.go文件干扰 - 如果项目用了多模块，
import路径得写全：比如模块名是github.com/you/app，就 import"github.com/you/app/mocks"
测试里忘写defer ctrl.Finish()，等于没测
测试跑完没报错，但业务逻辑根本没触发依赖方法？大概率漏了 defer ctrl.Finish()。这不是收尾仪式，是 EXPECT 校验的触发器——没它，所有 .EXPECT().Method(...).Return(...) 全被忽略，mock 调用变成空转。
实操建议：
- 每份测试开头就写
ctrl := gomock.NewController(t)，紧接着就是defer ctrl.Finish() - 必须用
defer，不能放在 if 分支里，也不能条件性跳过 - 一个测试里多个 mock 可共用一个
ctrl，不用每个都 new
最容易被忽略的是：interface 必须导出、mockgen 不处理 internal 包、ctrl.Finish() 缺一不可。这三处任一出错，mock 就形同虚设。
