goos和goarch设置不生效的常见原因包括：windows cmd中set后需在同一窗口执行go build，powershell须用$env:goos="linux"而非set，macos/linux的export变量不被子shell继承，ide终端未加载shell配置文件，以及cgo_enabled=0虽可绕过cgo失败但会改变runtime行为。
GOOS和GOARCH设置不生效的常见原因
直接设 GOOS=linux GOARCH=arm64 go build 却生成了 macOS 二进制，说明环境变量没被 Go 工具链读取到。这不是 bug，而是 shell 作用域或平台限制导致的。
- Windows CMD 下用
set GOOS=linux设置后，必须在同一 CMD 窗口执行go build，新开窗口变量丢失 - PowerShell 中要用
$env:GOOS="linux"，不是set，否则无效 - macOS/Linux 的
export必须在当前 shell 会话中执行，不能写进脚本后直接./script.sh—— 那会起新子 shell，变量不继承 - 某些 IDE（如 VS Code）的终端未加载 shell 配置文件（
~/.zshrc），需手动 source 或重启 IDE 终端
CGO_ENABLED=0 不是万能解药
加 CGO_ENABLED=0 能绕过 cgo 编译失败，但代价是 runtime 行为改变：DNS 解析走纯 Go 实现（可能无法访问企业内网 DNS）、os/user.Lookup 返回空、net.InterfaceAddrs() 在部分 Linux 发行版上失效。
- 若项目用了
github.com/mattn/go-sqlite3或golang.org/x/sys/unix，CGO_ENABLED=0会导致构建失败或 panic -
CGO_ENABLED=1是默认值，但 Go 不报错也不提示——它会静默降级为CGO_ENABLED=0，你得靠go build -x搜gcc行来确认是否真调用了交叉 C 编译器 - 真正需要 cgo 时，必须配目标平台 GCC，比如
CC=aarch64-linux-gnu-gcc，且要配CGO_CFLAGS="-I/path/to/sysroot/usr/include"
Windows 上编译 32 位程序要先准备工具链
在 64 位 Windows 上直接 GOARCH=386 go build 大概率失败，报错类似 cannot find package "syscall" 或链接失败。Go 官方预编译包不带 386 工具链，必须从源码构建。
- 确认 Go 是从源码安装（
%GOROOT%\src存在），不是官网下载的 .msi 包 - 打开 CMD，执行：
set GOARCH=386→cd %GOROOT%\src→make.bat --no-clean - 完成后，再在项目目录运行
GOARCH=386 go build -o app.exe main.go - 注意：每次新开 CMD 都要重新
set GOARCH=386，除非写进系统环境变量
Docker 是最省心的交叉编译方式
本地配环境变量 + CGO 工具链容易漏掉 sysroot 或头文件路径，Docker 直接封装好目标平台完整环境，尤其适合 CI 或多平台批量构建。
- 用官方镜像即可：
docker run --rm -v $(pwd):/app -w /app golang:1.22-alpine sh -c "CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o myapp-arm64 ." - 若需 cgo，选带 GCC 的镜像：
docker run --rm -v $(pwd):/app -w /app golang:1.22 bash -c "apt update && apt install -y gcc-aarch64-linux-gnu && CC=aarch64-linux-gnu-gcc CGO_ENABLED=1 GOOS=linux GOARCH=arm64 go build -o myapp ." - 避免把
go mod download放进容器每次重拉，可先本地go mod vendor，再 COPY vendor/ 进容器
file 命令输出的架构信息。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
