//go:build标签必须紧贴package声明前且中间不能有空行，否则失效；需同时保留//go:build和// +build双写法以兼容工具链；-tags参数用逗号分隔表示AND关系。
build tag 必须写在文件顶部，且紧贴 package 声明前
Go 编译器只认文件开头、package 语句之前（且**不能有空行**）的构建约束注释。一旦中间插了空行或注释，整个 //go:build 就失效，文件会被无条件参与编译——这是最常踩的坑。
必须同时保留新旧两种写法才能兼容所有工具链：
-
//go:build linux || darwin是 Go 1.17+ 官方语法，支持逻辑运算符 -
// +build linux darwin是遗留写法，空格表示 OR，逗号表示 AND - 两行都得写，顺序不限，但缺一不可；否则
go list、IDE 补全、CI 构建可能出错
go build -tags 参数里用逗号分隔多个 tag，不是空格
命令行传入的 -tags 值是 AND 关系：你写 go build -tags=dev,sqlite，表示“同时满足 dev 和 sqlite 才启用该文件”。而空格分隔（如 -tags="dev sqlite"）在某些 shell 或 CI 环境中容易被截断或解析异常，尤其当 tag 名含下划线或特殊字符时。
常见错误现象：go build -tags "dev prod" 看似想激活两个环境，实际只启用了第一个（dev），因为 go 工具链把整个字符串当做一个 tag 名处理。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 正确写法：
go build -tags=dev,prod - 若要表达 OR 逻辑（比如“linux 或 darwin”），必须写在
//go:build行里，不能靠命令行 - 标签名建议全小写、无下划线（如
dev、jsoniter），避免和内置约束（linux、cgo）冲突
不同环境配置必须拆成独立 .go 文件，不能塞进同一个文件里
比如 config_dev.go 和 config_prod.go 都定义 var Redis string，只要它们分别加了 //go:build dev 和 //go:build prod，就不会报 redeclared in this block 错误——因为编译器根本不会把两个文件同时拉进来。
反模式是用 if os.Getenv("ENV") == "prod" 动态加载配置：所有环境的代码都打进二进制，既增大体积，又绕过编译期校验（比如 prod 缺 TLS 字段，直到上线才暴露）。
- 每个环境一个文件，包名一致，变量名一致，靠 build tag 隔离
- 构建时显式指定：
go build -tags=prod -o server-prod . - 可配合
-ldflags注入版本号或 commit hash，但密钥类信息仍应通过 build tag 隔离（如//go:build !test屏蔽测试用硬编码密钥）
交叉编译平台专属代码时，tag 要和 runtime.GOOS 严格对应
Build Tags 不是运行时判断的替代品。比如你想为 Windows 写路径逻辑，别在代码里写 if runtime.GOOS == "windows"，而是新建 path_windows.go，顶部加 //go:build windows。这样既能避免跨平台编译失败（比如 macOS 上 import "syscall" 会报错），又能防止二进制混入无用代码。
注意：内置约束名（linux、windows、arm64）大小写敏感，且不能加引号或前缀；自定义 tag 如 mock_db 则完全由你控制。
- 多条件组合示例：
//go:build linux && cgo表示仅 Linux + cgo 启用 - 排除逻辑：
//go:build !windows表示非 Windows 平台生效 - 测试隔离常用：
go test -tags=integration只跑带//go:build integration的测试文件
