golang跨平台编译需禁用cgo并正确设置goos和goarch，否则易因动态链接或架构不匹配导致运行失败；推荐使用cgo_enabled=0、显式指定目标平台、添加-ldflags="-s -w"减小体积，并在真实环境中验证核心功能。
Windows下交叉编译Linux程序总失败？先关CGO
Windows本地默认启用CGO（CGO_ENABLED=1），一旦代码里调用了cgo或依赖了含C代码的包（比如net包在某些场景下会触发），编译出的Linux二进制就会带动态链接依赖，扔到Linux服务器上直接报./app: not found或no such file or directory——其实不是文件没找到，而是找不到libc.so.6这类系统库。
- 强制静态编译：始终加
CGO_ENABLED=0前缀，例如CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o server main.go - 验证是否真静态：Linux上用
file server看输出是否含statically linked；用ldd server应返回not a dynamic executable - 注意副作用：关CGO后
os/user、net等包的行为可能降级（比如user.Current()返回空用户名），需提前测试
Mac M1/M2编译amd64 Linux服务端，别信默认架构
MacBook用ARM芯片（GOHOSTARCH=arm64），但绝大多数云服务器仍是x86_64。如果只设GOOS=linux不指定GOARCH，Go会默认用宿主架构arm64，结果编译出的linux/arm64二进制在Intel服务器上根本跑不起来，报错cannot execute binary file: Exec format error。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 明确指定目标架构：
GOOS=linux GOARCH=amd64 go build -o app-linux-amd64 main.go - M1/M2用户若真要部署到ARM服务器（如树莓派、AWS Graviton），才用
GOARCH=arm64，但务必确认目标系统内核支持（uname -m输出aarch64） -
go tool dist list可查所有合法组合，避免拼错GOARCH（比如写成arm64v8或arm都不行）
Windows CMD里设环境变量语法和Linux/macOS不一样
Linux/macOS用export GOOS=linux，Windows CMD得用SET GOOS=linux，而且变量设置**只对当前CMD窗口生效**。如果写成GOOS=linux go build这种“内联写法”，CMD会当成执行一个叫GOOS=linux的命令，直接报错'GOOS=linux' is not recognized as an internal or external command。
- 正确做法：分两行写
SET GOOS=linux回车，再SET GOARCH=amd64回车，最后go build -o app.exe - PowerShell用户注意：
$env:GOOS="linux"才是正确赋值方式，SET在PowerShell里无效 - 推荐统一用内联方式避开环境变量作用域问题：
cmd /c "set GOOS=linux && set GOARCH=amd64 && go build -o app main.go"
减体积、去调试信息：-ldflags="-s -w"不是可选，是上线必备
默认编译出的二进制含完整调试符号和反射信息，动辄20MB+。对部署敏感的场景（比如嵌入式、容器镜像），这些信息毫无价值，反而拖慢启动、增大攻击面。
- 加
-ldflags="-s -w"能砍掉符号表和DWARF调试数据，实测体积减少30%~40%，且不影响运行时行为 -
-s去掉符号表，-w去掉DWARF信息，两者常一起用；单独用-s已足够应对大多数部署场景 - CI/CD脚本里建议固化该参数：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o bin/app main.go
runtime.GOOS硬编码判断、甚至filepath.Join在Windows路径里的反斜杠处理，都可能成为目标平台上的隐性雷。编译只是第一步，必须在真实目标环境中验证启动、网络、文件I/O等核心路径。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
