Kratos框架依赖下载失败的根本原因是本地Go环境链路断裂，具体表现为protoc版本低于3.21、GO111MODULE未开启或GOPROXY不可用，三者任一不满足均会导致kratos new或make init静默失败。
Kratos框架依赖下载失败时，项目卡在kratos new或make init阶段，根本原因不是代码写错，而是本地Go环境链路断裂——protoc版本错、GO111MODULE没开、GOPROXY不可用这三项中任意一项不满足，都会导致模板拉取静默失败或go mod tidy中途退出。
确认kratos命令是否真正可用
执行 which kratos，有输出才说明已安装并加入PATH；若无输出，运行 go install github.com/go-kratos/kratos/cmd/kratos/v2@latest，并确认 $GOPATH/bin 已写入系统 PATH 环境变量。
很多开发者以为 go install 执行完就万事大吉，但 Linux/macOS 下常漏掉 export PATH=$PATH:$GOPATH/bin 这一步，Windows 则需手动把 %GOPATH%\bin 加进系统环境变量。没有这步，终端根本找不到 kratos 命令。
检查三大前置条件是否全部对齐
第一步：验证 protoc 版本 ≥ 3.21，执行 protoc --version；低于该版本会直接导致 api/ 目录下 .pb.go 文件生成失败，且错误信息极隐蔽——只报“file not found”，实际是插件加载失败。
第二步：确认 GO111MODULE=on，执行 go env GO111MODULE，输出必须为 on；关闭状态下 kratos new 生成的 go.mod 会被忽略，后续所有依赖操作（包括 protoc-gen-go 安装）都失效。
第三步：国内环境必须设 GOPROXY=https://goproxy.cn,direct，否则 kratos new 会卡死在拉取 github.com/go-kratos/kratos-layout 模板这一步，超时后只留下空文件夹，没有任何提示。
【GO111MODULE=on 和 GOPROXY 缺一不可，二者任一缺失，kratos new 生成的项目从第一秒起就是残缺状态】
快速修复依赖下载失败的实操路径
方法一：删掉当前失败项目，重跑带镜像源的初始化命令：
kratos new helloworld -r https://gitee.com/go-kratos/kratos-layout.git
方法二：若已生成项目但 make init 报错，先清理缓存再重试：
rm -rf $HOME/go/pkg/mod/cache && go clean -modcache
然后进入项目根目录，手动执行 make init 中列出的每条 go install 命令，逐个验证是否成功——尤其注意 protoc-gen-go-grpc 必须用 v1.3.0+ 版本，v1.32+ 因接口变更会导致 Kratos 无法识别注册函数。
方法三：跳过全局安装，改用 go run 方式临时触发依赖下载：
go run github.com/go-kratos/kratos/cmd/kratos/v2@latest new demo
这能绕过 $GOPATH/bin 路径问题，适合 CI 环境或权限受限的开发机。
