Go开发环境能运行不等于工程可稳定编译发布，关键在于GOOS、CGO_ENABLED、GO111MODULE等开关必须配对；如CGO_ENABLED=0是Alpine容器部署默认安全选项，否则因glibc与musl libc不兼容导致“not found”错误。
Go 开发环境能跑起来，不等于工程能稳定编译发布；很多问题不是环境没装对，而是 GOOS、CGO_ENABLED、GO111MODULE 这几个关键开关没配对。
go version 和 go env 验证失败的常见原因
终端执行 go version 报 “command not found”，或 go env 显示 GOROOT 为空，大概率是 PATH 没生效，而不是 Go 没装好。
- Linux/macOS 下检查
/etc/profile或~/.zshrc是否包含export PATH=$PATH:/usr/local/go/bin（路径需与实际GO_ROOT一致） - 执行
source ~/.zshrc后再验证，别只改文件就以为完事 - Windows 用户注意：PowerShell 和 CMD 的环境变量不互通，Jenkins 构建用的是哪个 Shell，就得在对应环境里配
- 如果
go env GOPATH返回空，不代表有问题——Go 1.16+ 默认启用模块模式，GOPATH不再强制参与构建，但go mod init仍需可写路径
CGO_ENABLED=0 是容器化部署的默认安全选项
本地 go build 成功，但放进 Alpine 镜像后报 /bin/sh: ./myapp: not found，根本原因是动态链接库缺失，不是路径错了。
- Alpine 使用 musl libc，而默认
go build会链接 glibc，二者不兼容 - 加
CGO_ENABLED=0强制纯静态编译，生成的二进制不依赖系统 C 库 - 副作用：无法使用
cgo调用 C 代码（比如某些数据库驱动、图形库），若必须用，得换golang:alpine基础镜像并安装gcc和musl-dev - Jenkins 构建脚本里建议写成：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp .，显式指定目标平台
go mod init 后依赖拉不下来？先看 GOPROXY
go mod tidy 卡住或报 cannot find module providing package，八成是代理没设或设错。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 国内推荐配置：
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,https://proxy.golang.org,direct - 不要只设一个代理地址，
direct是兜底项，防止私有模块（如公司内网 Git）被代理拦截 - 如果用私有仓库（如 Gitee、GitLab），需额外加
go env -w GONOPROXY=git.example.com，否则模块会被当成公开包去代理站找 -
go mod download -x可打印详细下载过程，比go mod tidy更容易定位卡在哪一步
CI/CD 中 go build 失败常因工作目录和 GOPATH 冲突
Jenkins 或 GitHub Actions 里执行 go build 报 cannot find package，往往不是代码问题，而是构建上下文混乱。
- 确保构建步骤首行是
cd $WORKSPACE（Jenkins）或cd $GITHUB_WORKSPACE（GitHub Actions），避免在根目录或临时目录执行 - 不用
go install，它会把二进制写到$GOPATH/bin，而 CI 环境通常没设GOPATH或权限不足；一律用go build -o ./bin/app输出到项目内路径 - 如果项目含
/cmd子目录，构建命令应为go build -o ./bin/app ./cmd/myapp，不能只写./...，否则可能打包错入口 - Go 1.21+ 默认开启
GO111MODULE=on，但旧 Jenkins slave 可能未升级，建议显式加上GO111MODULE=on环境变量
真正麻烦的从来不是“怎么装 Go”，而是不同环境（本地开发、CI 构建、容器运行）下 GOOS/GOARCH/CGO_ENABLED 的组合差异，以及模块代理和私有仓库的混合配置。这些参数一旦漏掉一个，编译产物就可能在某个环节失效，而且错误提示还特别模糊。
