go语言跨平台编译关键在于同时显式设置goos和goarch环境变量并关闭cgo_enabled=0；漏设任一变量或未关cgo易导致格式错误、动态链接失败或构建失败。
Go 语言跨平台编译不是“能不能”的问题，而是 GOOS 和 GOARCH 是否同时显式设置、CGO_ENABLED 是否关对的问题。漏设任一变量，或没关 CGO_ENABLED，大概率会生成无法运行的二进制——比如在 Linux 上报 cannot execute binary file: Exec format error，或 Windows 上双击无反应。
GOOS 和 GOARCH 必须成对出现，不能只设一个
Go 不会“猜”你想要的目标架构。只设 GOOS=linux 而不设 GOARCH，它就沿用当前机器的 GOARCH（比如你 Mac 是 arm64，结果就是 linux/arm64；但你要的是 linux/amd64，那就错了）。
- 正确写法（推荐用
env前置，避免污染 shell）：env GOOS=linux GOARCH=amd64 go build -o myapp-linux . - 错误写法：
export GOOS=linux; go build -o myapp .（GOARCH没设，结果不可控） - 查当前值用：
go env GOOS GOARCH，别信 IDE 或 CI 脚本里残留的设置 - 支持哪些组合？运行：
go tool dist list，输出如linux/amd64、windows/arm64、darwin/arm64—— 不在列表里的组合直接失败
CGO_ENABLED=0 是稳定交叉编译的默认安全开关
只要你的代码没 import "C"，也没依赖 SQLite、OpenSSL 等必须 cgo 的第三方库，就该关掉 CGO。否则 Go 会尝试链接宿主机的 C 库（比如 macOS 的 libSystem、Linux 的 glibc），而目标平台根本没有对应动态库，运行时直接 panic 或找不到符号。
- 关 CGO 编译：
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o app.exe . - 开 CGO 编译（仅限必要场景）：
CGO_ENABLED=1 CC_x86_64_w64_mingw32=gcc-x86_64-w64-mingw32 GOOS=windows GOARCH=amd64 go build .—— 此时你得自己装好交叉 C 工具链，且极易卡在gcc: command not found - 检查是否含 cgo 文件：
go list -f '{{.CgoFiles}}' ./，返回非空切片说明有import "C"或 cgo 注释 - 关 CGO 后，
net包 DNS 解析会 fallback 到 Go 自实现（读/etc/resolv.conf），os/user可能返回空或 panic —— 这是预期行为，不是 bug
build constraints exclude all Go files 是最常被忽略的构建失败信号
这个错误不是编译器坏了，是 Go 扫完所有 .go 文件，发现每个都被构建约束跳过了。典型原因有两个：
- 文件顶部写了
// +build windows，但你当前GOOS=linux，该文件被排除；其他文件也类似，最后没剩一个可编译的 - 用了平台限定函数却没做适配，比如
_linux.go里调了syscall.Kill，_windows.go里用了windows.CloseHandle，但公共接口文件没加任何构建标签，导致它被所有平台编译 —— 结果在GOOS=windows下编译时，syscall.Kill报错未定义 - 验证方法：
go list -f '{{.GoFiles}}' ./看哪些文件被实际纳入构建；用//go:build替代旧式// +build（Go 1.17+ 推荐） - 避免硬写
syscall.Stat_t这类底层类型；优先用os.Stat()、runtime.GOOS等高层抽象
真正难的不是命令怎么敲，而是判断代码里有没有隐式依赖平台的行为：比如直接调 syscall、用 os/exec.Command 启动只有某系统才有的命令、路径拼接硬写 "\"、或文件权限设成 0755 却期望在 Windows 上生效。这些不会让 go build 失败，但会让二进制在目标平台静默出错。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
