Go交叉编译需通过GOOS和GOARCH环境变量指定目标平台，如GOOS=linux GOARCH=amd64；CGO_ENABLED=0通常需同时设置以避免libc依赖问题。
go build 时如何指定目标平台（GOOS/GOARCH）
交叉编译是 Go 构建中最常被忽略的配置点。默认 go build 生成的是当前机器的可执行文件，但上线部署往往需要 Linux amd64 或 ARM64；本地开发用 macOS，CI 流水线却跑在 Ubuntu 上——不显式指定就会出错。
必须通过环境变量控制，命令行参数无效（go build --os=linux 是错的）：
GOOS=linux GOARCH=amd64 go build -o myapp ./cmd/myappGOOS=darwin GOARCH=arm64 go build -o myapp-mac ./cmd/myapp- Windows 32 位：设
GOARCH=386，不是x86 - ARM64 设备（如树莓派 4、M1 Mac）统一用
GOARCH=arm64，别写成aarch64
注意：CGO_ENABLED=0 要和 GOOS/GOARCH 同时设置，否则某些平台（如 Alpine Linux 容器）会因缺失 libc 而 panic。
减小二进制体积：-ldflags 的关键组合
Go 编译出的二进制默认带调试符号和版本信息，动辄 10MB+。生产部署前应精简：
立即学习“go语言免费学习笔记（深入）”；
- 去掉符号表和调试信息：
-ldflags="-s -w" - 注入构建时间与 Git 提交哈希：
-ldflags="-X 'main.BuildTime=$(date -u +%Y-%m-%dT%H:%M:%SZ)' -X 'main.GitHash=$(git rev-parse --short HEAD)'" - 若项目含 cgo 依赖（如 SQLite、OpenSSL），禁用 cgo 后才能用
-s -w，否则链接失败
示例完整命令：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o myapp ./cmd/myapp
模块构建中 go.mod 和 go.sum 的影响
Go Modules 不只是管理依赖，它直接决定构建行为：
- 没有
go.mod时，go build会退化为 GOPATH 模式，可能误读旧缓存或找不到本地包 -
go.sum校验失败（如依赖被篡改或网络污染）会导致构建中断，错误信息是checksum mismatch - 升级依赖后务必运行
go mod tidy，否则go build可能静默使用旧版本 - 私有模块需配置
GOPRIVATE环境变量，否则go build会尝试走 proxy.golang.org 导致超时
验证当前模块状态：运行 go list -m all 查看实际加载的依赖及版本。
GOBIN 与 $PATH 配合实现全局命令安装
想让自定义工具像 go 或 git 那样直接敲名执行，不能只靠 go build -o 输出到某目录：
-
go install ./cmd/mytool@latest才是正确方式，它会把二进制放到$GOBIN下（默认$GOPATH/bin） - 必须确保
$GOBIN在$PATH中，否则 shell 找不到命令 - 模块路径（
module github.com/user/mytool）必须和go install的路径匹配，否则报错no matching versions - 如果项目还没打 tag，用
@master或@v0.0.0-xxx替代@latest
检查是否生效：which mytool 应输出 $GOBIN/mytool 路径。
真正麻烦的从来不是参数记不住，而是不同场景下参数要组合使用——比如交叉编译 + 静态链接 + 版本注入，漏掉任意一环都可能导致线上启动失败或日志无法溯源。
