GOOS和GOARCH必须同时设置，缺一不可；仅设GOOS=linux而不指定GOARCH会导致沿用本机架构，可能因目标服务器架构不匹配而报exec format error；常见错误如build constraints exclude all Go files，本质是GOARCH未设致构建标签匹配失败；Mac编译Linux amd64须明确写GOOS=linux GOARCH=amd64；Windows PowerShell用户需用env命令一次性赋值；ARMv7设备还需额外设GOARM=7；CGO_ENABLED=0是跨平台静态链接前提，否则依赖目标机libc导致Alpine等环境运行失败。
GOOS和GOARCH必须同时设置，缺一不可
只设 GOOS=linux 而不指定 GOARCH，Go 会沿用你本机的架构（比如 M1 Mac 默认是 arm64），但目标服务器可能是 amd64——编译出来的二进制扔过去直接报 cannot execute binary file: exec format error。
常见错误现象：build constraints exclude all Go files，本质是构建标签（如 // +build linux）匹配失败，因为 Go 拿你没设的 GOARCH 去比对，结果找不到满足条件的文件。
- Mac 编译 Linux amd64：必须写
GOOS=linux GOARCH=amd64，不能省略任一 - Windows PowerShell 用户别用
$env:GOOS="linux"单独赋值——后续go build不会自动读取，得用env GOOS=linux GOARCH=arm64 go build -o app这种一次性方式 - ARMv7 设备（如树莓派 3）需额外加
GOARM=7，且仅在GOARCH=arm时生效
CGO_ENABLED=0 是跨平台静态链接的前提
只要你的代码没 import "C"、没用 github.com/mattn/go-sqlite3 这类含 cgo 的包，就该默认关掉 CGO。否则生成的二进制依赖目标机的 libc/glibc，在 Alpine 容器或嵌入式 Linux 上运行会报 standard_init_linux.go:228: exec user process caused: no such file or directory。
开了 CGO 又在 macOS 编译 Linux 版本？大概率卡在 exec: "aarch64-linux-gnu-gcc": executable file not found——这不是 Go 的锅，是你缺交叉 C 工具链。
立即学习“go语言免费学习笔记（深入）”；
- 安全写法：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o server main.go - 真要调 C 库（如 OpenSSL、SQLite），就得用 Docker 模拟目标环境：
docker run --rm -v $(pwd):/work -w /work golang:1.21-alpine go build -o app main.go -
CGO_ENABLED=0会影响net.InterfaceAddrs()在某些旧系统上的行为，上线前务必实测
路径拼接必须用 filepath.Join()，别手拼
直接写 dir + "/config.yaml" 或 dir + "\" + "data.json"，在 Windows 上极易生成 C: oo\bar.txt 这种非法路径；在 Unix 上则可能多出冗余反斜杠。Go 不会自动帮你清理或转义。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
filepath.Join() 才是唯一靠谱的方式：它按当前 OS 自动选分隔符，还会清理 ".."、空段和重复分隔符。
- 用户输入路径：
filepath.Join(dirFlag, "data.json")，不是dirFlag + "/data.json" - 组合家目录：
filepath.Join(os.Getenv("USERPROFILE"), "AppData", "Local", "app")（Windows）或filepath.Join(os.Getenv("HOME"), ".cache", "app")（Linux/macOS） - 遍历子目录：
filepath.Join(root, entry.Name())，避免root + "/" + entry.Name()在 Windows 上崩 - 日志打印路径可用
filepath.ToSlash(path)统一为/，但千万别对os.Open()参数调这个函数——它会让 Windows 找不到文件
生成的二进制不带配置和资源文件
交叉编译只处理 .go 源码，config.yaml、templates/、static/ 这些全靠你手动打包。代码里写死 "./config.yaml" 是最大陷阱——二进制挪到别的目录就失效。
正确做法是用 os.Executable() 定位可执行文件位置，再拼相对路径：
exePath, _ := os.Executable() rootDir := filepath.Dir(exePath) configPath := filepath.Join(rootDir, "config.yaml")
这个逻辑在 Windows、Linux、macOS 下都成立，且能绕过工作目录变动带来的问题。
最容易被忽略的是：你本地测试时工作目录恰好是项目根目录，所以 "./config.yaml" 看似能跑；一放到 systemd 或容器里，工作目录变了，程序立刻找不到配置——这种问题往往要等部署后才暴露。
