protoc-gen-go-grpc 找不到的根本原因是未加入 PATH 或命名不规范；需确保 $GOPATH/bin 在 PATH 中、文件名为 protoc-gen-go-grpc（无后缀/软链接）、protoc 版本 ≥3.12，并补全 grpc/protobuf 依赖且运行 go mod tidy。
protoc-gen-go-grpc 插件找不到：明明装了却报 command not found
根本原因不是没装，而是 protoc 找不到它——插件必须在 $PATH 里，且文件名要严格匹配 protoc-gen-go-grpc（不能带版本后缀、不能是软链接名）。Go 模块安装默认放在 $GOPATH/bin，但这个路径常不在系统 PATH 中。
- 确认是否已用 Go 安装：
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest - 检查生成的二进制是否存在：
ls $GOPATH/bin/protoc-gen-go-grpc（注意没有.exe后缀，Windows 也一样） - 把
$GOPATH/bin加进PATH（例如 Bash 下加export PATH=$PATH:$GOPATH/bin到~/.bashrc） - 验证：
protoc-gen-go-grpc --version能输出版本才说明真正就位
protoc 命令里 -plugin 参数多余？为什么加了反而报错
protoc 自动按命名规则查找插件，只要 protoc-gen-go-grpc 在 PATH 里，就不需要手动指定 -plugin。硬加反而容易写错路径或名字，触发 Plugin failed with status code 1 或更模糊的 exec: "protoc-gen-go-grpc": executable file not found。
- 正确调用方式：
protoc --go-grpc_out=. --go-grpc_opt=paths=source_relative your_service.proto - 错误示范：
--plugin=protoc-gen-go-grpc=/path/to/binary—— 不仅冗余，还可能因路径权限、符号链接失效导致失败 - 注意：
--go-grpc_out是 gRPC 的输出开关，不是--go_out；两者必须分开调用（--go_out生成 pb 结构，--go-grpc_out生成服务接口）
go-grpc 生成代码不兼容 Go mod：missing go.sum entry
生成的 *_grpc.pb.go 文件顶部会 import google.golang.org/grpc 和 google.golang.org/protobuf/runtime/protoiface 等，如果本地模块没显式 require 这些依赖，go build 会报 missing entry 错误，而不是编译失败——这是 Go module 的校验机制在起作用。
- 运行
go get google.golang.org/grpc@latest和go get google.golang.org/protobuf@latest补全依赖 - 确保
go.mod里有对应require行，且版本与你protoc-gen-go-grpc安装时锁定的兼容（比如 v1.3+ 插件需 grpc v1.60+） - 别跳过
go mod tidy：它会自动补go.sum并清理未用依赖，不执行就容易卡在“找不到符号”类报错
macOS / Windows 上 protoc 版本太老，不支持 --go-grpc_out
--go-grpc_out 是 protoc 3.12+ 引入的原生参数，旧版（如 3.6、3.11）只认 --plugin + 手动路径方式，强行用新参数会提示 Unknown flag: --go-grpc_out。
- 查当前版本：
protoc --version（输出形如libprotoc 3.11.4） - 升级方式：
- macOS：
brew install protobuf（Homebrew 默认装最新稳定版） - Windows：从 GitHub releases 下载预编译
protoc-*.zip，解压后把bin/protoc.exe放进PATH
- macOS：
- 验证：升级后
protoc --help | grep go-grpc应该能搜到相关选项
protoc 本身太旧——它不报错，只是静默忽略不认识的参数，结果什么都没生成。 
