Kratos官方要求Go 1.21及以上版本，低于此版本会导致kratos new失败、go mod tidy卡住或wire.Build未定义等错误；需通过go version验证，并确保GOROOT指向新版路径。
Kratos框架对Go版本有明确的最低要求，低于该版本将无法完成项目初始化或编译失败，尤其在依赖注入、泛型支持和模块加载机制上会直接报错。
官方推荐的Go版本范围
必须使用 Go 1.21 及以上版本。Kratos v2.x 系列（当前主力稳定版）深度依赖 Go 1.21 引入的泛型增强、embed 包稳定性改进以及 go mod 的隐式依赖解析能力。若使用 Go 1.20 或更低版本，执行 kratos new 后运行 go mod tidy 会卡在 google.golang.org/protobuf 模块解析阶段，并提示 incompatible version 错误。
Go 1.26.0 可用但非首选——它虽能跑通基础服务，但部分 Kratos 生态工具（如 protoc-gen-go-http/v2）尚未完全适配其新引入的 unsafe.Slice 行为变更，可能导致 HTTP 路由注册时 panic。
验证本地Go环境是否达标
在终端中执行：go version
输出必须形如 go version go1.21.3 darwin/arm64 或更高。若显示 go1.20.12 及以下，请立即升级。
注意：仅安装新版本不等于生效。需确认当前 shell 中 $GOROOT 指向的是新版 Go 安装路径，否则 kratos new 仍会调用旧版编译器。可运行 which go 和 go env GOROOT 双重核对。
关键兼容性陷阱与绕过方式
方法一：强制指定 Go 版本生成项目（适用于团队多版本共存场景）
进入项目根目录后，在 go.mod 文件首行手动将 go 1.20 改为 go 1.21，再执行 go mod tidy。这一步不可跳过，否则 wire.go 中的泛型注入函数将无法编译。
方法二：临时切换 GOPATH 下的 Go 解释器（仅调试用）
若无法全局升级 Go，可将新版 go 二进制文件复制到 $GOPATH/bin/go，并确保该路径在 $PATH 中优先于系统默认路径。但这会导致其他 Go 项目意外使用新版解释器，【不建议长期使用】。
方法三：使用容器隔离（生产推荐）
直接基于 golang:1.21-slim 镜像构建开发环境，彻底规避宿主机版本冲突。Dockerfile 中无需额外声明 GO111MODULE，因该镜像已默认启用。
常见错误日志与对应版本问题
第一步：看到 undefined: wire.Build 报错 → 检查 go.mod 顶部的 Go 版本声明是否 ≥1.21，且 go install github.com/google/wire/cmd/wire@latest 使用的是同一版本的 go 命令安装。
第二步：执行 kratos run 时 panic 提示 cannot convert []byte to ~string → 这是 Go 1.23+ 中字符串底层结构变更引发的兼容问题，【Kratos 当前稳定版暂不支持 Go 1.23+】，请降级至 Go 1.21 或 Go 1.22。
第三步：make api 失败，日志含 field has no name → proto 文件中用了 float 类型而非 float32/float64，该语法检查在 Go 1.21+ 的 protoc-gen-go 插件中才启用，说明你的 protoc-gen-go 版本与 Go 不匹配。
