必须安装并升级Kratos CLI工具至最新稳定版，执行go install github.com/go-kratos/kratos/cmd/kratos/v2@latest后立即运行kratos upgrade，再通过kratos version验证版本号是否生效。
要在本地快速搭建 Kratos 微服务项目，必须先安装并保持 CLI 工具为最新版本，否则执行 kratos new 或 kratos proto client 时会因命令缺失、参数不兼容或生成代码格式错误而失败。
安装 Kratos CLI 工具
推荐使用 go install 方式安装，这是 Go 1.16+ 官方推荐的二进制工具安装方式，不会污染 GOPATH，且可精准控制版本。
执行以下命令安装最新稳定版：
go install github.com/go-kratos/kratos/cmd/kratos/v2@latest
该命令会从 GitHub 主仓库拉取 v2 分支的最新 tagged 版本（非 main 分支快照），避免因使用开发中代码导致生成器行为异常。若网络不稳定，可改用国内镜像源：
go install github.com/go-kratos/kratos/cmd/kratos/v2@v2.11.0（替换为当前已知可用的稳定版本号）
安装完成后，【必须执行 kratos upgrade】，否则部分子命令（如 kratos proto add）将不可用——这是 v2.10.0 起引入的强制升级机制，跳过会导致后续所有 proto 相关操作报错。
验证与定位安装路径
运行 kratos version 查看输出，正常应显示类似 v2.11.0 的语义化版本号；若提示 command not found，说明 $GOBIN 或 $GOPATH/bin 未加入系统 PATH。
可通过 go env GOBIN 查看默认安装路径，常见位置有：
- Linux/macOS：
$HOME/go/bin（当GOBIN为空时） - Windows：
%USERPROFILE%\go\bin
将对应路径添加至 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile），再执行 source 生效。
升级已有 CLI 工具
方法一：一键升级（推荐）
直接运行 kratos upgrade，它会自动检测远程最新版本并覆盖安装，无需手动卸载。
方法二：指定版本重装
若需回退或测试特定版本，先用 which kratos 确认当前二进制位置，再执行：
go install github.com/go-kratos/kratos/cmd/kratos/v2@v2.10.3
注意：不同 Go 版本对 @latest 解析策略略有差异，Go 1.21+ 更严格遵循模块发布规则，因此显式指定版本号可彻底规避解析歧义。
升级后务必再次运行 kratos version 确认版本变更生效，旧版本残留可能导致 make api 生成的 _http.pb.go 缺失路由注册逻辑。
