Protobuf生成失败主因是工具链、路径或语法未对齐：protoc≥3.21且protoc-gen-go=v1.31，proto须放api/xxx/v1/下并严格匹配package与go_package声明，缺third_party依赖或插件将导致字段缺失或空文件。
proto 生成失败不是代码写错了，而是工具链、路径或语法三者中至少有一处没对齐——90% 的报错静默发生，不提示具体原因，只留空文件或编译错误。
protoc 和 protoc-gen-go 版本不匹配导致 .pb.go 缺字段或为空
kratos proto add 或 go generate ./ 后，api/ 下的 .pb.go 文件里没有字段定义、方法为空，甚至整个文件只有 package 声明，大概率是版本错配。
-
protoc --version必须 ≥ 3.21；低于此值无法解析google/api/annotations.proto，option (google.api.http)被跳过，HTTP 映射失效 -
protoc-gen-go必须用 v1.31（不是 v1.32+）；v1.32+ 因google.golang.org/protobuf接口变更，会跳过生成，只留下空的conf.pb.go或helloworld.pb.go - 验证方式：在项目根目录执行
protoc --version和protoc-gen-go --version，别只信go install输出
proto 文件路径或 package 声明不符合 Kratos 约定
kratos proto server/client 只扫描 api/ 子目录，且对 package 和 go_package 有强校验。放错位置或写错声明，生成直接静默跳过。
- 文件必须放在
api/xxx/v1/xxx.proto这类路径下，不能是internal/api/、proto/或根目录下的xxx.proto -
package必须与目录结构完全一致：如路径为api/user/v1/user.proto，则package user.v1；写成package user或package api.user.v1都会导致生成的 Go 包路径错乱 -
option go_package必须显式声明，格式为"user/api/user/v1;v1"—— 左侧是相对路径（对应文件系统），右侧是 import 别名；漏写或路径不一致，import时会报cannot find package
缺少必要插件或 third_party 依赖导致 validate/http 生成失败
加了 validate 规则却没生效，或写了 option (google.api.http) 却没生成 HTTP handler，基本是插件缺失或依赖未就位。
- 必须安装
protoc-gen-go-grpc（非旧版protoc-gen-grpc-go）和protoc-gen-go-http；缺任一，kratos proto client/server不会报错，但生成的代码里没有RegisterXXXServiceServer或HTTPRouter -
validate规则需要third_party/validate/validate.proto文件存在；该文件不能靠go install自动带入，得手动从 protoc-gen-validate 仓库复制到项目third_party/目录下 - 执行
protoc命令时，-I参数必须包含third_party/和 Kratos 官方 proto 路径：-I . -I third_party -I $(go list -f '{{.Dir}}' -m github.com/go-kratos/kratos)/proto
生成后没验证关键产物就直接 kratos run
项目目录建出来 ≠ 能跑。很多团队卡在 kratos run 报 undefined: InitializeApp 或 unknown field 'xxx' in conf.Config，其实问题早在生成阶段就埋下了。
- 检查
internal/conf/conf.proto是否存在，且其生成的internal/conf/conf.pb.go中结构体字段与configs/config.yaml的 key 完全一致（大小写、下划线） - 打开
cmd/server/wire.go，确认有func InitializeApp()；这是 Wire 注入入口，删了或没生成，kratos run直接失败，不给任何配置类提示 - 运行
go mod tidy再试一次；模板里的go.mod可能与你本地 Go 1.21+ 不兼容，tidy会自动修正依赖版本
最常被忽略的是：kratos proto add 和 kratos proto server 都要求在项目根目录（即含 go.mod 的目录）执行，进到 api/ 或 cmd/server 下运行，命令会静默失败，不报错也不生成任何东西。
