Go环境配置三大关键点：PATH和GOROOT需手动验证生效，go mod init前须脱离GOPATH/src并清理vendor，跨平台编译应默认禁用CGO（CGO_ENABLED=0）并配合GOOS/GOARCH使用go tool dist list查可用组合。
Go 环境装好了才能编译，但很多人卡在 go version 报错或 go build 生成的二进制在目标机器上跑不起来——根本原因不是 Go 没装对，而是环境变量、模块模式、CGO 这三样没对齐。
go command not found？先确认 PATH 和 GOROOT 是否真生效
安装完 Go 后执行 go version 报错，90% 是 PATH 没生效。不要信安装器“已添加到 PATH”的勾选框，它常失效。
- macOS/Linux：运行
which go，没输出就说明 PATH 没加对；检查/usr/local/go/bin（pkg 安装）或/usr/local/bin（brew 安装）是否写进了~/.zshrc或~/.bash_profile - Windows：用 PowerShell 运行
Get-Command go，失败则去「系统属性 → 高级 → 环境变量」里确认%GOROOT%\bin（如C:\Program Files\Go\bin）确实在用户或系统 PATH 中 - 验证
GOROOT：运行go env GOROOT，输出应是非空路径；若为空，手动设置go env -w GOROOT=/usr/local/go（macOS/Linux）或go env -w GOROOT="C:\Program Files\Go"（Windows）
go mod init 失败？清理 vendor/ 和 GOPATH/src 冲突
go mod init 静默失败或生成错误 module 名，大概率是项目目录还在旧式 GOPATH/src 下，或残留了 vendor/ 目录。
- 切出
GOPATH/src：运行go env GOPATH，如果当前路径以该值开头（如/home/user/go/src/myapp），就 cd 到任意其他目录（比如~/projects/myapp）再初始化 - 删掉
vendor/：除非你明确要用 vendor 模式，否则直接rm -rf vendor，避免模块解析混乱 - 强制启用模块：运行
go env -w GO111MODULE=on，尤其 CI 脚本或老终端可能仍关着
编译出的二进制在目标机器上 panic 或报 missing library？关掉 CGO
默认开启的 CGO_ENABLED=1 会让 Go 链接 libc 等系统库，导致跨平台二进制依赖宿主环境——比如 Linux 上编译的程序在 Alpine 上跑不了，Mac 编译的在 CentOS 上报 undefined symbol: clock_gettime。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 一律用
CGO_ENABLED=0编译纯静态二进制：例如CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app - 例外场景：只有当你调用了 C 函数（比如用
#include <sys/stat.h>或调用 OpenSSL）才必须开 CGO，此时需确保目标机器有对应头文件和库，且CC环境变量指向交叉编译器（如x86_64-linux-musl-gcc） - 注意：
CGO_ENABLED=0会禁用net包的 cgo DNS 解析器，改用纯 Go 实现——对大多数服务无影响，但若依赖 /etc/resolv.conf 特定配置（如 search domain），需额外测试
二进制太大？用 -ldflags="-s -w" 削减体积
默认编译的二进制含调试符号和 DWARF 信息，动辄 20MB+。生产部署前建议裁剪。
-
-s：去掉符号表 -
-w：去掉 DWARF 调试信息 - 组合使用：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -ldflags="-s -w" -o server，实测可减少 30%–40% 体积 - 注意：
-s -w后无法用delve调试，仅用于发布版；开发时保留默认编译
真正容易被忽略的是：GOOS 和 GOARCH 的组合并非全部可用，比如 GOOS=windows GOARCH=arm64 在 Go 1.21+ 才支持，旧版本会静默忽略；而 GOOS=linux GOARCH=mips 需要源码构建支持。查可用组合，最稳的方式是运行 go tool dist list ——别猜，直接看。
