生产环境必须用 go build 编译成二进制文件；go version 需 ≥1.21，GOROOT 要正确配置；go mod init 必须在项目根目录执行；交叉编译需设置 GOOS/GOARCH；CLI 启动失败主因是权限、平台不匹配或 cgo 动态库缺失。
go 命令能直接运行源码，但生产环境必须用 go build 编译成二进制可执行文件——这是 Go 项目交付和部署的刚性要求，不是可选项。
验证 go 是否可用且版本合规
别跳过这步。很多编译失败其实卡在工具链本身没装对。
-
go version必须输出go1.21或更高（2026 年主流项目已普遍要求go1.22+）；低于go1.20的版本无法使用go install新语法，也无法兼容多数云原生组件 - 如果报
command not found，说明PATH没包含GOROOT/bin（Windows 是C:\Go\bin，Linux/macOS 通常是/usr/local/go/bin） - 执行
go env GOROOT确认路径是否指向真实安装目录；若为空或错误，需手动设置环境变量
go mod init 必须在项目根目录执行
不初始化模块，go build 仍能编译单文件，但一旦引入第三方包（比如 github.com/spf13/cobra），就会报 no required module provides package。
- 新建项目目录后，cd 进入该目录，再运行
go mod init myapp（myapp是模块名，建议与最终二进制名一致） -
go.mod文件生成后，后续所有go get、go build都以此为作用域；不能在src/下或子目录里 init - 模块名不一定要是域名，但若未来要发布到公共仓库，建议用
github.com/yourname/myapp格式
go build 编译时的平台与输出控制
Go 默认编译当前系统架构的二进制，但跨平台构建很常见——比如 macOS 开发，却要部署到 Linux 服务器。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 编译当前平台：直接
go build -o myapp main.go（main.go必须含package main和func main()） - 交叉编译 Linux 版本：
GOOS=linux GOARCH=amd64 go build -o myapp-linux main.go - 编译 ARM64 服务器版：
GOOS=linux GOARCH=arm64 go build -o myapp-arm64 main.go - 加
-ldflags="-s -w"可减小体积（剥离调试符号和 DWARF 信息），适合生产环境
控制台应用启动失败的三个高频原因
编译成功 ≠ 运行成功。控制台程序（CLI）常因环境或权限问题卡在启动环节。
立即学习“go语言免费学习笔记（深入）”；
-
permission denied：Linux/macOS 下生成的二进制默认无执行权限，需chmod +x myapp -
cannot execute binary file: Exec format error：一定是平台不匹配（比如在 x86_64 机器上运行了 arm64 编译产物） - 依赖动态库缺失（极少见，但 Go 一般静态链接）：仅当用了
cgo且调用了 C 库时才可能出现，此时需确认目标机器有对应.so或.dylib
go build 命令前漏掉一个 cd 或写错 GOOS，就会导致整条流水线产出不可用二进制。 
