Go跨平台交叉编译成功的关键是同时显式设置GOOS和GOARCH，并关闭CGO_ENABLED=0；漏设任一变量或启用CGO，易导致目标机器报cannot execute binary file或no such file or directory。
Go跨平台交叉编译不是“能不能”，而是GOOS和GOARCH是否同时显式设置、CGO_ENABLED是否关对——漏一个，生成的二进制大概率在目标机器上直接报cannot execute binary file或no such file or directory。
GOOS和GOARCH必须成对显式设置，不能只设一个
Go不会补全、不警告、不猜测。只设GOOS=linux不设GOARCH，它就用你当前机器的架构（比如 macOS M1 上默认出 darwin/arm64）；只设GOARCH=arm64不设GOOS，结果还是darwin/arm64。
- 正确写法：
GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 . - Windows 目标要自己加
.exe后缀：GOOS=windows GOARCH=amd64 go build -o app.exe . - 查所有合法组合别硬记：
go tool dist list，输出如linux/amd64、windows/arm64、darwin/arm64 -
darwin已弃用386，GOOS=darwin GOARCH=386会直接报错
CGO_ENABLED=0 是默认必须加的开关，不是可选项
开启CGO_ENABLED=1会让 Go 尝试调用宿主机的gcc并链接本地 C 库（如 macOS 的libSystem.dylib、Linux 的glibc）。你在 macOS 上编译 Linux 二进制，它却去找glibc——链接失败；就算侥幸过掉，运行时也常因 libc 版本不匹配 panic。
- 纯 Go 项目（没
import "C"、没用github.com/mattn/go-sqlite3等含 cgo 的第三方包）：一律加CGO_ENABLED=0 - 检查有没有 cgo 文件：
go list -f '{{.CgoFiles}}' ./，返回非空切片说明有依赖 - 关 CGO 后，
net包 DNS 解析会 fallback 到 Go 自实现（读/etc/resolv.conf），os/user.Current()可能返回空或 panic——这是预期行为，不是 bug
遇到 import "C" 就得面对现实：要么删，要么配工具链
只要源码树里任意一个.go文件写了import "C"（包括第三方包），整个构建就强制进入 cgo 模式。此时CGO_ENABLED=0会直接报错：cannot use cgo when CGO_ENABLED=0；不关又链接失败。
立即学习“go语言免费学习笔记（深入）”；
- 常见藏 cgo 的包：
github.com/mattn/go-sqlite3、旧版golang.org/x/sys/unix补丁、某些os/exec扩展 - 快速扫描依赖：
go mod graph | grep -i sqlite\|crypto\|openssl - 临时绕过（仅限调试）：
//go:build !cgo放在main.go顶部，再配合CGO_ENABLED=0 - 真要保留 cgo？得配目标平台的交叉 C 工具链，比如
CC_linux_arm64=aarch64-linux-gnu-gcc，复杂度远超 Go 本身
验证不能只看文件名，file 和 ldd/otool 才算数
文件名叫app-linux-amd64不代表它真是 Linux AMD64 的——可能只是本地重编译。真正确认靠命令：
- Linux 目标：
file app-linux-amd64应输出ELF 64-bit LSB executable, x86-64；ldd app-linux-amd64应显示not a dynamic executable（如果关了 CGO） - macOS 目标：
file app-darwin-arm64应含Mach-O 64-bit executable arm64；otool -l app-darwin-arm64 | grep -A2 LC_BUILD_VERSION可看 SDK 版本 - Windows 目标：
file app.exe应含PE32+ executable (console) x86-64
最常被忽略的是构建约束导致build constraints exclude all Go files——不是编译器坏了，是所有.go文件都被// +build跳过了，比如_linux.go文件在GOOS=windows下直接被排除，最后没剩一个可编译的。
