kratos new生成的项目不能直接运行，必须先执行kratos proto client/server生成.pb.go文件，并在internal/cmd下运行wire gen生成injector，否则kratos run会因undefined: initializeapp或missing package等错误退出。
kratos new 生成的项目不能直接跑起来，必须先处理 wire 依赖注入和 proto 代码生成两个环节，否则 kratos run 会报错退出。
kratos new 后为什么 kratos run 报错？
新生成的项目里，internal/server/grpc/server.go 和 internal/service/xxx_service.go 都依赖 wire 生成的 injector，而 wire gen 默认不执行；同时，api/xxx/xxx.pb.go 等文件也未生成，导致编译失败。
-
kratos new helloworld只创建骨架，不生成任何 Go 代码（包括 pb、wire、ent） - 首次运行前必须手动执行
kratos proto client api/helloworld/helloworld.proto和kratos proto server api/helloworld/helloworld.proto -t internal/service - 接着要进入
internal/cmd目录运行wire gen，否则main.go找不到InitApp函数 - 如果跳过这步直接
kratos run，你会看到类似undefined: app.InitApp或cannot find package "helloworld/api/helloworld"的错误
proto 文件修改后如何增量更新？
改了 .proto 文件后，不能只跑一次 kratos proto server 就完事——它不会自动覆盖已存在的 service 实现，也不会刷新 client 接口签名，容易造成 runtime panic 或编译不通过。
- 先删掉旧的 pb 文件：
rm -f api/helloworld/helloworld.pb.go api/helloworld/helloworld_grpc.pb.go - 再重新生成 client：
kratos proto client api/helloworld/helloworld.proto - 服务端模板建议用
-f强制覆盖：kratos proto server api/helloworld/helloworld.proto -t internal/service -f - 最后别忘了
wire gen，否则新增的 RPC 方法在 service struct 里没实现，启动时会 panic - 注意：如果 proto 中加了新 message，但没在 service 方法里用到，
kratos proto server不会自动把它塞进internal/service/xxx_service.go，得手补
go mod tidy 报错 missing go.sum entry 怎么办？
kratos v2 依赖链里混用了多个版本的 google.golang.org/protobuf 和 google.golang.org/grpc，尤其在升级 Go 1.24+ 后，go mod tidy 容易卡在 checksum 不一致上。
- 先清理本地缓存：
go clean -modcache - 强制指定 protobuf 版本（推荐 v1.34.2）：
go get google.golang.org/protobuf@v1.34.2 - 再运行
go mod tidy -e（带-e忽略部分错误），然后手动检查go.sum是否有冲突行 - 常见冲突点是
github.com/go-kratos/kratos/v2间接拉了v1.33.0，而你的 proto plugin 用的是v1.34.2，此时需在go.mod顶部显式 require 一次高版本 - 如果仍失败，临时把
GO111MODULE=off关掉，用 vendor 模式：go mod vendor && go build -mod=vendor ./cmd/...
wire 注入器和 proto 生成是 Kratos 项目真正的“启动开关”，不是可选步骤；很多团队在 CI 中漏掉 wire gen 或 pb 重生成，上线后才发现新接口根本没注册进去——这种问题不会在本地 kratos run 时报错，但服务一启动就 panic。
