go 1.10+无需手动配置goroot，gopath默认为$home/go；mockgen需单独安装且依赖$gopath/bin在path中，否则报command not found。
Go 1.10+ 环境下无需手动设置 GOROOT，GOPATH 默认为 $HOME/go；mockgen 必须单独安装且依赖 $GOPATH/bin 在 $PATH 中，否则直接报 command not found。
GOROOT 和 GOPATH 还用不用配
从 Go 1.10 开始，GOROOT 完全由 go 命令自动推导，只要 $PATH 包含 Go 安装目录下的 bin/（如 /usr/local/go/bin），就不用再 export GOROOT。同理，GOPATH 自 1.8 起也默认启用，值为 $HOME/go，除非你明确想换路径，否则不设更安全。
常见踩坑点：
- 手动设置了
GOPATH但没把$GOPATH/bin加进$PATH，导致go install安装的工具（比如mockgen）找不到 - macOS 或 Linux 用户改了
~/.zshrc却忘了source ~/.zshrc，或在错误 shell 中验证 - Windows 上用 PowerShell，但只改了用户环境变量没重启终端，或根本没加
%GOPATH%\bin到系统 Path
mockgen 安装失败或找不到命令
mockgen 不是 Go 自带命令，必须显式安装。Go 1.16+ 推荐用：
go install github.com/golang/mock/mockgen@latest
装完立刻验证：
mockgen -version
如果报 command not found，说明安装路径不在 $PATH。检查：
- 运行
go env GOPATH确认实际GOPATH路径 - 确认
$GOPATH/bin是否在$PATH中（echo $PATH | grep go） - Windows 用户注意：
go env GOPATH输出的是 Unix 风格路径，但环境变量要用 Windows 路径格式，例如C:\Users\xxx\go\bin
mockgen -source 生成空文件或 interface not found
这个错误几乎全是路径和包名不匹配导致的。关键点：
-
-source后必须是相对路径，开头带./，比如./storage/user.go；写成storage/user.go会找错位置 - 目标文件里的接口必须首字母大写（导出），且不能定义在
main包里 - 如果接口在外部模块（如
github.com/myorg/core），别用-source，改用-package+-destination：mockgen -destination mocks/user_mock.go -package mocks github.com/myorg/core UserStore
- 不确定包名？先执行
go list -f '{{.Name}}' ./storage看输出是否和源文件顶部package storage一致
生成的 mock 方法签名和原接口对不上
最常触发的两个原因：
-
error不在返回值末尾：比如原方法是func Get(id int) (error, *User)，mockgen会误判error位置，导致调用时 panic。必须把error放最后，或加-build_flags="-tags=mock"并配合自定义构建标签 - 泛型接口支持有限：像
type Repo[T any] interface { Save(t T) error }这类，mockgen v1.6.0+只能处理极简泛型，复杂情况建议拆出非泛型接口再 mock，否则直接跳过或报错
嵌套结构体里有未导出字段时，EXPECT() 链式调用可能失效——这不是配置问题，是生成逻辑限制，得检查 struct 字段是否都导出了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
