protoc编译器必须手动下载安装，不能用go install；protoc-gen-go和protoc-gen-go-grpc须用go install带版本号安装；proto中option go_package必须写对；protoc命令需按--go_out在前、--go-grpc_out在后的顺序调用。
protoc 编译器必须手动装，不能靠 go install
protoc 是独立于 Go 的 C++ 工具，go install 对它完全无效。你得去 GitHub releases 页面 下载对应系统的预编译二进制包（比如 protoc-24.3-linux-x86_64.zip），解压后把 bin/protoc 放进 $GOPATH/bin 或 /usr/local/bin，再确保该路径在 PATH 里。
常见错误是：执行 protoc --version 报 “command not found”，本质就是 PATH 没配对，或者解压后没把 protoc 文件复制过去。
protoc-gen-go 和 protoc-gen-go-grpc 必须用 go install，且带版本号
这两个是 Go 写的插件，必须用 go install 安装，不是 go get。新版（2024 年起）已弃用 github.com/golang/protobuf/protoc-gen-go，改用官方路径：
go install google.golang.org/protobuf/cmd/protoc-gen-go@latestgo install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
@latest 或指定版本（如 @v1.33.0）容易生成不兼容的代码——比如 protoc-gen-go-grpc v1.4+ 生成的接口默认带 UnimplementedXXXServer，旧版 gRPC 运行时会 panic。
proto 文件里 option go_package 必须写对，否则 import 路径错乱
option go_package 不只是“生成到哪”，它直接决定 Go 包的导入路径和模块解析行为。写法必须是 "path/to/pkg;alias"，其中 path/to/pkg 是相对于 go.mod 根目录的相对路径。
例如你的 go.mod 在 /home/user/myproject，想把生成的代码放在 pb/ 目录下、包名叫 pb，就得写：option go_package = "./pb;pb";
如果写成 "pb;pb" 或 "github.com/user/myproject/pb;pb"，go build 会报找不到包，或生成代码后 import 语句指向错误位置。
protoc 命令参数顺序和插件调用逻辑容易搞混
protoc 本身不生成 Go 代码，它靠插件驱动。--go_out=. 触发 protoc-gen-go，--go-grpc_out=. 触发 protoc-gen-go-grpc，两者必须同时出现，且 --go_out 必须在前——因为 protoc-gen-go-grpc 依赖 protoc-gen-go 生成的基础类型。
典型命令是：protoc --go_out=. --go-grpc_out=. helloworld.proto
漏掉任一参数、顺序颠倒、或路径写错（比如 --go_out=pb/ 但没创建该目录），都会导致只生成部分文件，或者报 plugin not found 错误——其实不是插件没装，而是 protoc 找不到可执行文件，因为没在 PATH 里。
go_package 要和模块路径一致，protoc 的输出路径要和 Go import 路径能对上。任意一环偏移，编译就失败，但错误信息通常不直接告诉你哪错了。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
