Kitex必须强依赖Protobuf，所有服务接口、结构体和错误定义均源自.proto文件；删掉import或漏写option go_package会导致kitex静默失败、运行时报undefined，且HTTP网关需额外引入kitex-http或自建转换。
Kitex的.proto强依赖怎么绕不开
Kitex不是“能用Protobuf”，而是“必须用Protobuf”。kitex命令生成的代码里，所有服务接口、结构体、错误定义都来自.proto文件；一旦你删掉import "google/protobuf/timestamp.proto"，或漏写option go_package，kitex -module xxx gen就会静默失败，但运行时才报undefined: xxxServiceClient。
常见错误现象：go run .直接panic，提示找不到NewXXXClient——其实不是代码没生成，是kitex-gen包路径和go.mod里声明的模块名不一致，导致导入失败。
- 必须在
.proto顶部写全option go_package = "xxx/yyy;zzz"，且zzz要和go.mod中模块名最后一段一致 - HTTP网关不能直接用Kitex原生服务，得额外引入
kitex-http或自己写http.Handler转调client - 升级Kitex版本后，必须重跑
kitex命令，否则新旧IDL解析逻辑不兼容，Decode可能panic
Go-Zero的goctl生成器为什么容易踩坑
goctl快是真的快，但快的前提是你写的.api或SQL DDL本身是合法且自洽的。它不校验业务逻辑，只做语法映射，所以生成的代码编译失败，90%是因为源头定义有隐性错误。
常见错误现象：执行goctl api go -api=user.api -dir=.后，go build报undefined: sqlx.ErrNotFound——实际是user.api里用了int64类型，但没在文件顶部加import "github.com/zeromicro/go-zero/core/stores/sqlx"。
立即学习“go语言免费学习笔记（深入）”；
-
goctl model mysql生成的CRUD代码默认用sqlx，如果项目里用的是gorm，得手动替换，框架不自动适配ORM -
goctl rpc生成的服务默认监听0.0.0.0:8080，若部署在K8s里没改listenOn配置，会因端口冲突启动失败 - cache层生成的
redis.NewRedis要求配置项路径为redis.host，写成redis.addr会导致panic: redis: empty addr
限流熔断在跨实例场景下为什么表现不同
Kitex默认限流走sliding window内存计数器，单实例内有效；Go-Zero v1.4.x的limit中间件也是内存型，但v1.7+开始支持redislimiter插件——这个差异直接影响你是否需要立刻接入Redis。
使用场景：电商秒杀流量打到3台API节点，如果只靠Kitex默认限流，每台各自计数，总QPS可能超阈值3倍；Go-Zero开redislimiter后，所有节点共享一个滑动窗口，行为可预测。
- Kitex要分布式限流，得自己封装
redis.Incr+ Lua脚本，或者集成sentinel-go - Go-Zero的
breaker默认基于gobreaker，状态存在内存里，跨实例不共享；需配合etcd或redis做状态同步，文档里没明说，但生产环境必须做 - 两者都支持自定义fallback逻辑，但Kitex的
fallback只对RPC生效，HTTP接口得手动包一层middleware，Go-Zero的Breaker中间件天然覆盖HTTP入口
新人上手时最常卡在哪一步
Kitex卡在“连通性验证”：写了.proto、生成了代码、启了server，但curl localhost:8888/health 404——因为Kitex原生不提供HTTP路由，/health得自己用net/http另起一个端口暴露，或加kitex-http网关。
Go-Zero卡在“目录结构误解”：以为service/order/api和service/order/rpc是两个独立服务，结果启动时发现rpc服务注册不到etcd——其实是rpc服务必须由api层主动client调用才能触发连接，空跑rpc二进制不会自动注册。
- Kitex新手建议先跑通
kitex -module demo example/hello官方示例，再改.proto，别从零写 - Go-Zero新手别跳过
goctl env check，它会检测go、protoc、mysql等工具链是否就位，缺一个都会让goctl model静默失败 - 两者都依赖
context做超时控制，但Kitex的client调用必须显式传ctx, cancel := context.WithTimeout(context.Background(), time.Second)，Go-Zero在api层已自动注入，rpc调用里直接用c.ctx就行
