Kratos中proto的package必须与目录路径严格一致（如api/greeter→kratos.api.greeter），go_package需写为"api/greeter/v1;v1"以确保导入路径与包名匹配，HTTP映射须import annotations.proto并启用protoc-gen-go-http插件，生成前须用buf check lint和buf build验证语法及依赖完整性。
在Kratos项目中，proto文件的package声明与go_package选项若配置错误，会导致生成的Go代码路径错乱、编译失败或gRPC服务注册异常，必须严格遵循目录结构与命名映射规则。
proto文件中package名必须与目录路径严格一致
打开api/greeter/greeter.proto，第一行必须写为：package kratos.api.greeter;。
这个kratos.api.greeter不是随意起的，它必须逐级对应文件所在路径：项目根目录 → api → greeter → greeter.proto；中间用点号连接，全部小写，不能含下划线或大写字母。
如果写成package api.greeter;或package kratos_api_greeter;，【生成的Go包路径将丢失顶层模块名，导致import冲突或找不到类型定义】。
go_package选项需同时指定导入路径和本地包名
在package声明下方，必须添加option go_package语句：
option go_package = "api/greeter/v1;v1";
等号右侧分号前的部分（api/greeter/v1）是该proto生成的Go代码将被import时使用的路径，必须与文件物理位置相对应；分号后的部分（v1）是生成代码在当前文件中声明的Go包名，用于避免同目录下多个proto文件生成的包名冲突。
若省略分号后内容，如写成option go_package = "api/greeter/v1";，则生成的Go文件默认包名为v1，但实际文件会落在api/greeter/v1/目录下——此时Go编译器会报错package v1; expected package greeter之类提示。
HTTP映射依赖google/api/annotations.proto且需插件支持
方法一：启用HTTP REST接口映射
在proto文件开头显式import "google/api/annotations.proto";，并在rpc方法中添加option (google.api.http)配置，例如：get: "/greeter/{name}"。
方法二：确保protoc命令调用时加载了protoc-gen-go-http插件，否则option (google.api.http)会被完全忽略，生成的api.bm.go中不会出现HTTP路由绑定逻辑。
注意：该annotations.proto文件本身不随Protobuf官方发布，必须通过buf或go install方式单独获取并放入third_party/google/api/目录，否则protoc编译直接报File not found错误。
生成代码前必须验证proto语法与依赖完整性
第一步：运行buf check lint检查proto语法规范性，确认无PACKAGE_NOT_LOWER_SNAKE_CASE等警告。
第二步：执行buf build --path api/greeter/greeter.proto验证依赖可解析，重点确认google/api/annotations.proto和validate/validate.proto是否能被正确定位。
第三步：使用protoc命令生成Go代码时，必须通过--go-grpc_out和--go-http_out分别指定输出目录，并确保--go-grpc_opt=paths=source_relative开启源码路径映射，否则生成的.pb.go文件会默认放在GOPATH下，脱离项目结构。
