kratos new是启动Kratos微服务项目的唯一正确起点，必须确保protoc≥3.21、protoc-gen-go=v1.31、GO111MODULE=on且GOPROXY=https://goproxy.cn,direct；生成后需验证internal/conf/conf.proto存在及cmd/server/wire.go中InitializeApp函数已声明。
kratos new 是启动 Kratos 微服务项目的唯一正确起点，手动建目录、复制配置或改 go.mod 会直接破坏依赖注入、协议生成和配置加载三者的契约关系，后续几乎必然卡在 conf.Load() panic 或 undefined: InitializeApp。
执行 kratos new 前必须确认的三件事
不是环境装了就能跑通，90% 的失败源于这三项没对齐：
-
protoc ≥ 3.21且protoc-gen-go = v1.31（注意：v1.32+ 因google.golang.org/protobuf接口变更，会导致api/下.pb.go生成失败） -
GO111MODULE=on必须启用——关闭时go mod download会漏掉google.golang.org/grpc/cmd/protoc-gen-go-grpc等关键工具 -
GOPROXY=https://goproxy.cn,direct必须生效——国内不设此值，kratos new会在拉取github.com/go-kratos/kratos-layout时静默超时，只留下空文件夹
生成后立刻验证的两个关键点
项目目录生成 ≠ 可运行。很多团队卡在“本地跑不起来”，其实问题出在这两处：
- 检查
internal/conf/conf.proto是否存在，并确认它已被internal/conf/conf.pb.go正确引用——缺失或引用错误会导致conf.Load()panic 报"unknown field 'xxx' in conf.Config" - 打开
cmd/server/wire.go，确认其中已声明InitializeApp函数——这是 Wire 依赖注入的入口，若被误删或未生成，kratos run会报undefined: InitializeApp，而非更友好的提示
kratos run 启动失败最常见的配置路径错误
命令本身没问题，但失败日志里出现 failed to load con...（截断），大概率是配置加载路径不对：
- Kratos 默认从
configs/config.yaml加载配置，路径写错、文件名大小写不符（如Config.yaml）、或 YAML 格式缩进错误都会导致加载失败 - 如果改过配置路径（比如用
-conf参数指定），请确认该路径下文件真实存在，且conf.Load()调用时传入的路径与实际一致 - 不要在
conf.proto中定义未在config.yaml中出现的字段，否则conf.Load()会 panic；反过来，config.yaml中多出的字段会被静默忽略
Kratos 的结构约束很硬，但每条规则背后都对应一个运行时契约。最容易被忽略的是：conf.proto → conf.pb.go → config.yaml → conf.Load() 这一整条链必须严格对齐，中间任何一环错位，都会在启动时崩得无声无息。
