goos和goarch必须成对设置，否则构建约束全不匹配导致“build constraints exclude all go files”；单设一个会沿用宿主机值，引发交叉编译失败。
GOOS/GOARCH没成对设置，编译直接跳过所有文件
现象是 build constraints exclude all Go files，尤其在用了 // +build linux 或 //go:build !windows 这类构建标签时。Go 不会只看 GOOS，它用 GOOS 和 GOARCH 联合匹配构建约束；单设一个，另一个沿用宿主机值，很可能导致全不匹配。
实操建议：
- 永远用
GOOS=linux GOARCH=amd64 go build这种显式组合，别写GOOS=linux go build - 查当前 Go 支持哪些目标：运行
go tool dist list | grep linux（或替换成windows、darwin） - ARM 架构注意区分：
GOARCH=arm64是标准写法，aarch64或armv8无效 - Mac M1/M2 用户编译 Linux amd64，必须显式写
GOARCH=amd64，不能依赖默认arm64
CGO_ENABLED=0 没设，二进制在目标机器上报 libc 找不到
典型错误信息：./myapp: /lib64/libc.so.6: version `GLIBC_2.34' not found 或 standard_init_linux.go:228: exec user process caused: no such file or directory。这不是 Go 报错，而是 Linux 动态链接器找不到对应 libc 版本——因为默认开启 CGO，生成的是动态链接二进制。
实操建议：
- 纯 Go 项目（没调
C、没用sqlite3、openssl等 cgo 依赖），一律加CGO_ENABLED=0 - 命令写法：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o app ./cmd/server - 别在 shell 里全局 export
CGO_ENABLED=0——会影响本地开发调试（比如net.InterfaceAddrs()行为可能变） - 若真要用 cgo，别在本地交叉编译，改用 Docker：
docker run --rm -v $(pwd):/work -w /work golang:1.22-alpine go build -o app
go.mod 路径与实际目录不一致，跨平台构建时依赖漂移
现象：本地 go build 成功，CI 上失败，报 cannot find module 或 import path doesn't match。根本原因是 go mod init example.com/myapp 初始化的模块路径，和你 clone 下来的实际文件路径不一致（比如 repo 在 github.com/team/proj，但 go.mod 写的是 example.com/proj）。
实操建议：
- 新建项目第一件事：
go mod init github.com/yourname/yourrepo（用真实 GitHub/GitLab 路径） -
go.mod和go.sum必须提交 Git，不能忽略 - CI 脚本里不要用
go get拉工具，统一用tools.go管理版本（否则golangci-lintv1.54 vs v1.57 规则不同） - 验证方式：在干净目录下
git clone后，直接go build ./...，不手动go mod download
Windows CMD/PowerShell 里交叉编译语法出错
现象：在 Windows 上执行 GOOS=windows GOARCH=amd64 go build 报错，提示“环境变量名格式不正确”或 go 命令未识别。这是 Windows 命令行语法和 Unix 完全不同导致的。
实操建议：
- CMD 正确写法：
set CGO_ENABLED=0 && set GOOS=windows && set GOARCH=amd64 && go build -o myapp.exe - PowerShell 推荐用
cmd /c "set CGO_ENABLED=0 && set GOOS=windows && set GOARCH=amd64 && go build -o myapp.exe" - 更省事：直接用 WSL 或 Git Bash，语法和 macOS/Linux 一致
- 生成的
.exe没图标不是编译问题，Go 原生不支持资源嵌入，得靠go-rsrc或go-winres工具后处理
GOOS 就够了，其实 GOARCH 没配对，构建标签就全失效；或者你在 macOS 上 go build 成功了，却忘了 CI 用的是 Linux runner，go env GOROOT 输出可能指向旧版 Go。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
