Go项目构建需协同配置环境变量（GOOS/GOARCH）、go build参数、CGO_ENABLED和构建标签：缺一不可，否则导致平台错乱、符号缺失或exec format error。
Go 项目构建参数不是靠命令行开关统一配置的，而是分场景、分用途、由不同机制控制：环境变量管平台目标，go build 参数管链接与输出，构建标签管代码包含，-tags 管条件编译。混用或漏设会导致二进制跑不起来、平台错乱、符号缺失。
GOOS 和 GOARCH 必须成对设置才能交叉编译
只设 GOOS=linux 不设 GOARCH，结果仍是当前机器架构（比如 macOS 上还是 darwin/amd64）；反过来也一样。Go 不会猜测你要编什么，缺一不可。
GOOS=linux GOARCH=arm64 go build -o myapp-linux-arm64 main.go-
GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go（Windows 下建议显式加.exe） - 查所有合法组合：
go tool dist list | grep linux或直接go tool dist list - 误用
GOARCH=x86_64或GOARCH=aarch64会静默失败——必须用amd64、arm64、386等标准值
CGO_ENABLED=0 是纯 Go 项目跨平台构建的默认前提
启用 CGO（即 CGO_ENABLED=1）会让编译器尝试调用目标平台的 C 工具链和头文件，而宿主机通常没有 Windows 的 windows.h 或 Linux 的 libc 头文件，直接报错。
- 纯 Go 项目（没
import "C"、没// #cgo、不依赖sqlite3/cgo等）→ 强烈加CGO_ENABLED=0 - 含 C 依赖的项目（如
github.com/mattn/go-sqlite3）→ 关掉CGO_ENABLED会报undefined: sqlite3.SQLiteConn，此时得用 Docker 构建或在目标平台本地编译 -
CGO_ENABLED=0还能生成完全静态二进制，扔进 Alpine 容器也能直接跑 - Windows 下默认
CGO_ENABLED=1，但纯 Go 程序设为 0 通常也没问题
构建标签（build tags）必须位置精准且显式启用
构建标签不是注释，它必须紧贴文件顶部，且与 package 声明之间有且仅有一个空行；多一个、少一个、缩进错位，标签就失效。
立即学习“go语言免费学习笔记（深入）”；
- 新语法（Go 1.17+ 推荐）：
//go:build linux || darwin，注意冒号后无空格 - 旧语法兼容写法：
// +build linux darwin（空格 = OR），// +build linux,amd64（逗号 = AND） - 不能同时存在
//go:build和// +build，否则报multiple build constraints - 自定义标签（如
debug、enterprise）必须通过go build -tags debug显式传入才生效；操作系统/架构标签（如linux）是自动识别的 - cgo + 构建标签组合时，除了标签匹配，还必须确保
CGO_ENABLED=1，否则 cgo 部分静默跳过
VSCode 中构建参数要写进 tasks.json 才生效
VSCode 不解析 go build 参数，它靠 tasks.json 的 command 字段执行完整 shell 命令。想加 -ldflags、-tags 或 -o，必须手动写进去，否则 Ctrl+Shift+B 就只是跑默认 go build。
-
command字段示例："go build -ldflags=\"-s -w\" -tags=prod -o ./bin/app ./cmd/main.go" - 路径要替换成你真实的入口文件，比如
./cmd/myapp/main.go - 调试前自动构建需在
launch.json中配preLaunchTask，且值必须和tasks.json中的label完全一致 -
program字段必须指向构建输出路径，例如"${workspaceFolder}/bin/app"，不能写main.go -
go run加参数不走tasks.json，只能手动在终端运行：go run -tags=dev main.go
最容易被忽略的是：构建参数之间存在隐式依赖——比如 CGO_ENABLED=0 和 GOOS/GOARCH 要一起用，-tags 和构建标签语法要匹配，tasks.json 里的 command 必须是完整可执行命令。任何一个环节断开，构建出来的二进制就可能在目标环境上直接报 exec format error 或符号未定义。
