Go原生支持多平台编译，但Makefile中必须每条命令前显式设置GOOS、GOARCH和CGO_ENABLED=0，否则默认仅构建当前系统平台；环境变量不继承，export无效；输出路径须带平台标识并加.exe后缀（Windows），且需用file等命令验证实际格式。
调试 Makefile 里 GOOS/GOARCH 不生效的问题
最常见现象是：make build-linux 执行完，file bin/app-linux 显示仍是 Mach-O（macOS）或 PE32+（Windows），说明根本没切到目标平台。根本原因不是变量写错，而是 Makefile 中 export GOOS=linux 对下一行无效——Make 的每一行命令都在独立 shell 中执行。
必须把环境变量和 go build 写在同一行：
build-linux: mkdir -p bin/ GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o bin/app-linux-amd64 ./cmd/myapp
别用 $(GOOS) 变量拼接路径，除非你真用了 define + foreach 动态生成 target；否则容易漏定义、难 debug。
验证构建结果是否真的跨平台
光看文件名没用，app-linux-amd64 在 macOS 上生成也可能是 Darwin 二进制。必须用系统命令确认实际格式：
立即学习“go语言免费学习笔记（深入）”；
- Linux/macOS：
file bin/app-linux-amd64→ 应含ELF 64-bit LSB executable, x86-64 - Windows（PowerShell）：
sigcheck64.exe -n bin\app-windows-amd64.exe或右键属性 → “版本”页签有 PE 头信息 - macOS：
file bin/app-darwin-arm64→ 应含Mach-O 64-bit executable arm64
如果报 cannot execute binary file，立刻检查 file 输出，别先改代码。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
CGO_ENABLED=0 被忽略导致构建失败或运行崩溃
错误表现分两类：
- 编译阶段失败：macOS 上
GOOS=linux却报exec: "gcc": executable file not found→ 说明没加CGO_ENABLED=0 - 运行阶段崩溃：Linux 二进制在 Alpine 容器里启动就
Segmentation fault→ 默认启用了 CGO，动态链接了宿主机的 glibc
解决方案只有一条：所有跨平台构建命令前，显式加 CGO_ENABLED=0。不要依赖全局设置，也不要只在部分 target 里加。它不是可选项，是默认安全起点。
VS Code 调试时无法 attach 到跨平台构建产物
dlv 不支持跨平台调试 —— 你不能在 macOS 上用 dlv attach 一个 Windows .exe，也不能在 Linux 上 attach 一个 darwin 二进制。调试目标必须和 dlv 运行平台一致。
正确做法是：
- 本地开发调试：用当前平台构建（
GOOS=darwin）+dlv debug或 VS Code 的launch.json启动 - 远程服务调试：在目标平台机器上构建（如 Linux 服务器），再用
dlv exec ./myapp --headless --addr=:2345启动服务端，本地 VS Code 用mode: "attach"连过去 - 务必加
-gcflags="-N -l"关闭编译优化，否则断点会跳、变量显示为optimized away
真正麻烦的从来不是“怎么编出多平台二进制”，而是“怎么让每个平台上的构建行为可预测、可验证、可复现”。环境变量不继承、CGO 默认开启、输出名不带标识、验证靠猜——这些细节堆在一起，才是调试卡住的主因。
