Go跨平台编译关键在于正确设置GOOS和GOARCH环境变量、关闭CGO以确保静态链接，以及配置GO111MODULE=on和GOPROXY=...direct保证模块依赖可靠；编译时使用-ldflags="-s -w -buildmode=pie"和-trimpath生成高性能无依赖二进制。
Windows/macOS/Linux 上用 go build 编译出高性能、跨平台、无依赖的二进制，关键不在装得多，而在环境变量、模块代理、编译参数这三处是否干净可控。
GO111MODULE=on 是默认但不是自动生效
Go 1.16+ 虽默认开启模块模式，但 Windows 的 CMD/PowerShell、macOS 的 zsh/bash 若已存在旧会话，GO111MODULE 可能仍为空或 auto，导致 go build 意外 fallback 到 GOPATH 模式，拉包失败或版本错乱。
- 验证当前值：
go env GO111MODULE，输出必须是on - 永久写入（推荐）：
go env -w GO111MODULE=on - 临时覆盖（调试用）：
GO111MODULE=on go build ./main.go - 若项目根目录下有
go.mod但go build报no required module，大概率是这个值没生效
GOPROXY 必须带 direct 后缀
只设 GOPROXY=https://goproxy.cn 看似够用，但遇到私有仓库、内部模块或 replace 指向本地路径时，会直接报错退出，不回源 —— 这是高频卡点。
- 正确配置：
go env -w GOPROXY=https://goproxy.cn,direct -
direct表示：代理查不到时，跳过代理，直连原始模块地址（如github.com/xxx） - 若公司用 Nexus 或 Artifactory 做私有代理，需把
direct换成对应域名，例如：https://nexus.example.com/repository/go/,direct - 验证是否生效：
go env GOPROXY输出应含,direct，且go list -m all不报Get "https://proxy.golang.org/..."类超时错误
编译高性能二进制的关键参数组合
go build 默认生成带调试信息、支持反射、可被 dlv 调试的二进制；生产部署需裁剪体积、关闭符号表、静态链接 —— 这些不能靠后期压缩，必须在编译时定死。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 最小体积 + 静态链接（推荐线上）：
go build -ldflags "-s -w -buildmode=pie" -trimpath ./main.go -
-s：去掉符号表和调试信息（减小 30–50% 体积） -
-w：去掉 DWARF 调试信息（与-s常一起用） -
-buildmode=pie：启用位置无关可执行文件（增强安全性，Linux 发行版强制要求） -
-trimpath：编译时不嵌入绝对路径（避免泄露开发机路径，CI/CD 必加） - 交叉编译 Windows 二进制（从 macOS/Linux）：
GOOS=windows GOARCH=amd64 go build -o app.exe ./main.go，注意CGO_ENABLED=0才能彻底静态链接（否则依赖 libc）
GOROOT 和 GOPATH 不再需要手动配，但不能删
Go 1.13+ 启用 Modules 后，GOPATH 对依赖管理已无作用，GOROOT 也由安装器自动写入；但部分工具链（如 gopls、VS Code Go 插件、go install 安装命令行工具）仍会读取它们，留空或指向错误路径会导致功能异常。
- 确认
GOROOT正确：go env GOROOT应指向你安装 Go 的真实路径（如C:\Program Files\Go或/usr/local/go） -
GOPATH可保持默认（$HOME/go），无需刻意修改；但不能删掉，否则go install会失败 - 不要把项目放在
$GOPATH/src下 —— Modules 模式下这是反模式，go mod init后项目可放任意路径 - 若
go install github.com/xxx/cli@latest报cannot find module providing package，先检查GOPATH是否为空或非法路径
真正影响编译结果的，从来不是“装了什么”，而是 go env 输出里那几行关键配置是否稳定、是否被 shell 会话缓存、是否在 CI 流水线中被覆盖 —— 每次构建前跑一遍 go env | grep -E "(GO111MODULE|GOPROXY|GOROOT|GOPATH)"，比重装十次 Go 更有效。
