protoc 找不到 protoc-gen-go 是因只查 PATH 而非 Go 模块路径；需用 go install google.golang.org/protobuf/cmd/protoc-gen-go@latest 并将 $HOME/go/bin 加入 PATH。
protoc 命令找不到 protoc-gen-go 插件
根本原因是 protoc 运行时只认环境变量 PATH 里的可执行文件，而不会自动查 Go modules 缓存或 go install 的默认目录（如 $HOME/go/bin）。很多用户装完 protoc-gen-go 后直接跑 protoc --go_out=. 报错：protoc-gen-go: program not found or is not executable。
解决方法很简单，但必须手动确认路径：
- 用
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest安装（注意不是旧版github.com/golang/protobuf） - 检查
which protoc-gen-go是否有输出；如果没有，把$HOME/go/bin加进PATH（Linux/macOS 加到~/.bashrc或~/.zshrc，Windows 在系统环境变量里补） - 别用
go get，它在 Go 1.21+ 已弃用且不保证生成可执行文件
Go 模块路径和 go_package 选项对生成结构体的影响
go_package 不只是“生成到哪个包”，它直接决定生成代码的 package 声明、导入路径、以及后续 go build 能否通过。常见错误是只写短名（如 go_package = "pb";），导致生成的 package pb 和实际模块路径不匹配，编译时报 cannot find package "pb"。
正确做法是让 go_package 和你的 Go module 路径一致：
立即学习“go语言免费学习笔记（深入）”；
- 若模块是
github.com/user/project，推荐写go_package = "github.com/user/project/pb"; - 生成命令里
--go_out对应的输出目录必须是./pb（即和go_package最后一段匹配） - 如果项目还没初始化 module，先运行
go mod init github.com/user/project，否则go build会拒绝识别本地包
Protobuf 版本、protoc-gen-go 版本与 google.golang.org/protobuf 的兼容性
三者版本不匹配会导致生成代码无法编译，最典型的是字段类型变成 *string 而不是 string，或 XXX_ 方法缺失。这不是 bug，是 Protobuf v4（即 google.golang.org/protobuf）和旧版 v1（github.com/golang/protobuf）的 API 断层。
当前唯一稳妥组合是：
-
protoc≥ 3.19（低版本不支持 v4 插件协议） -
protoc-gen-go来自google.golang.org/protobuf/cmd/protoc-gen-go（不是旧仓库） - 项目依赖用
google.golang.org/protobuf，而非github.com/golang/protobuf - 检查
go list -m google.golang.org/protobuf确保版本 ≥ v1.30
生成代码后 go build 报 undefined: proto.RegisterType
这是旧版代码残留的典型信号：你可能混用了 v1 和 v4 的 import 或生成插件。v4 完全移除了 proto 包里的注册机制，所有序列化逻辑由 google.golang.org/protobuf/encoding/prototext 等新包承担。
快速定位方式：
- 搜索生成的
.pb.go文件里是否含import "github.com/golang/protobuf/proto"—— 如果有，说明用了旧插件 - 运行
protoc-gen-go --version，输出应为v1.x.x（v4 插件），而不是1.5.3（v1） - 删掉旧插件二进制（
rm $(which protoc-gen-go)），重新go install新版
真正麻烦的不是装错，而是团队里有人用旧脚本、CI 缓存了旧二进制、或者 IDE 自带了老版 protoc —— 这些地方都得手动清。
