go条件编译必须用//go:build标签而非runtime.goos，因其是文件级编译门禁：需紧贴文件顶部、后跟空行、严格大小写、禁混//+build，否则静默忽略；多平台代码须拆文件实现。
Go 没有预处理器宏，但条件编译完全可行——关键在于用对构建标签（//go:build），而不是靠 runtime.GOOS 做运行时分支。后者会让所有平台代码都进二进制，白占体积、还可能触发未定义行为。
怎么写 //go:build 才不被忽略
构建标签不是注释，位置和格式错一点就失效：
-
//go:build必须紧贴文件最开头，前面不能有任何非空字符（包括空格、BOM、其他注释） - 后面必须跟一个**空行**，再接
package声明；漏掉这个空行，整个 tag 被静默忽略 - 别混用
//go:build和旧式// +build—— Go 1.17+ 推荐只用前者，它支持&&、||、!，语义清晰 - 大小写敏感：
linux有效，Linux无效；darwin是 macOS 的正确值，不是macos
平台相关代码该放哪儿：拆文件，别塞一个文件里
把 Windows、Linux、Darwin 的实现分别放到独立文件中，每个文件顶部打对应 //go:build：
-
fs_windows.go开头写：//go:build windows，然后空行，再package fs -
fs_linux.go开头写：//go:build linux -
fs_darwin.go开头写：//go:build darwin - 所有文件导出同名函数，比如
func GetTempDir() string，调用方无感知哪个被编译进来 - 切忌在一个
fs.go里写if runtime.GOOS == "windows"—— 这样所有平台都编译两套逻辑，且无法做平台专属初始化（比如 Windows 下加载 DLL）
go test 不会自动识别 build tags
写了 //go:build windows 的测试文件，在 Linux 上跑 go test 默认直接跳过，既不报错也不运行 —— 很容易误以为“已覆盖”，实际根本没测。
- 要运行带 tag 的测试，必须显式加
-tags参数：go test -tags=windows - CI 中验证多平台兼容性，得组合环境变量和 tag：
GOOS=windows go test -tags=windows，GOOS=linux go test -tags=linux - 测试入口
TestMain如果写在带//go:build darwin的文件里，Linux 上跑go test就完全看不到它，setup/teardown 全丢，但不会报错 - 测试文件名不能用
_windows_test.go这类后缀 ——go test只认*_test.go，后缀里的平台标识会被忽略
交叉编译时要不要关 CGO
用 GOOS=linux GOARCH=amd64 go build 生成 Linux 二进制时，如果项目用了 cgo（比如调了 net 包的某些底层功能），默认会链接宿主机 libc，导致在 Alpine 或无 libc 环境下崩溃。
- 纯静态链接、避免动态依赖，加
CGO_ENABLED=0：CGO_ENABLED=0 GOOS=linux go build -o app-linux main.go - 但关了 cgo 后，
net.InterfaceAddrs()、user.Lookup等函数行为会退化（比如返回空或模拟结果），得提前验证是否符合预期 - 若必须用 cgo（如调 OpenSSL），交叉编译前得配好对应平台的 sysroot 和 C 工具链，复杂度陡增；多数 CLI 工具建议直接关 cgo
最容易被忽略的是空行那一下——//go:build 后面少一个换行，整个文件就变成“普通 Go 文件”，平台专属逻辑彻底失效，而编译器连 warning 都不给。调试时先盯住这个空行，比查逻辑快十倍。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
