Go用构建标签在编译期控制平台特定代码，需严格遵循格式（如// +build linux），推荐结合文件名后缀和runtime.GOOS/GOARCH运行时判断，cgo需配stub回退并注意交叉编译限制。
用构建标签（build tags）控制平台特定代码编译
Go 不支持运行时动态加载平台相关逻辑，必须在编译期决定哪些代码参与构建。核心手段是构建标签——它不是注释，而是被 go build 解析的元信息。
常见错误是把构建标签写成普通注释，比如：// +build linux 前面漏了空行，或写成 //+build linux（中间没空格），这会导致标签被忽略，所有平台都编译该文件。
- 构建标签必须出现在文件最开头，且前面有空行
- 同一文件可叠加多个标签，例如：
// +build linux darwin表示仅在 Linux 或 macOS 下编译 - 用逗号表示“与”，用空格表示“或”：
// +build linux,amd64限定 Linux + AMD64；// +build windows linux表示 Windows 或 Linux - 推荐用文件名后缀替代部分标签，如
net_linux.go和net_windows.go，更直观且无需手动维护标签
用 runtime.GOOS 和 runtime.GOARCH 做运行时分支
构建标签解决的是“编译进不进”，但有些逻辑必须在运行时判断，比如临时目录路径、信号处理、进程权限检查。这时要用 runtime.GOOS 和 runtime.GOARCH。
注意：它们是常量字符串，不是函数调用，所以不会带来运行时开销；但过度依赖运行时分支会让测试变难——你得在每种 OS 上跑一遍才能覆盖全路径。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 典型误用：在 hot path（如网络包处理循环）里反复查
runtime.GOOS == "windows"，其实只需初始化时查一次并存到包级变量 - 跨平台调试时，别只信本地环境：用
GOOS=linux GOARCH=arm64 go build交叉编译后，在目标环境验证行为 - 某些系统调用（如
unix.Syscall）只存在于golang.org/x/sys/unix，且仅在 Unix-like 平台可用，Windows 下直接 import 会编译失败——必须配合构建标签隔离
处理 cgo 与平台原生库的耦合问题
一旦启用 cgo，平台差异会急剧放大：头文件路径、链接器参数、符号可见性、甚至 C 编译器版本都可能出问题。cgo 文件天然需要构建标签保护，但容易漏掉配套的纯 Go 回退实现。
比如想调用 Linux 的 inotify 监控文件变化，又希望 Windows 下用 ReadDirectoryChangesW，但若没写好 fallback，Windows 用户 go build 就会报 “undefined: unix.INotifyInit”。
- 永远为 cgo 依赖提供纯 Go 的 stub 实现（哪怕只是返回
ErrUnsupported），并用构建标签分隔：fs_linux.go（含 cgo）、fs_stub.go（无 cgo，// +build !linux） - cgo 文件顶部必须有
/* #cgo LDFLAGS: -lrt #include <sys/inotify.h> */
这类声明，且import "C"必须紧随其后，中间不能有空行或其它语句 - 交叉编译时 cgo 默认关闭，设
CGO_ENABLED=1后还要确保目标平台的 C 工具链可用，否则会卡在 “exec: 'gcc': executable file not found”
测试平台特定逻辑的实用策略
写完平台相关代码，最难的是验证它真正在目标系统上按预期工作。光靠本地 GOOS=xxx 是不够的，因为 syscall 行为、文件权限、环境变量默认值都不同。
最容易被忽略的一点：CI 环境往往只跑一个平台（比如 GitHub Actions 默认 Ubuntu），结果 macOS 或 Windows 的 bug 要等用户提 issue 才暴露。
- 用
buildable测试文件：新建os_test.go，加上// +build linux darwin windows，里面只做最小化平台探测断言，确保各平台至少能编译通过 - 对关键路径（如配置加载、日志输出目录）加
if runtime.GOOS == "windows" { t.Skip("skip on windows until XXX is fixed") }，比让测试直接 panic 更利于定位 - Docker + multi-stage 是最省事的跨平台验证方式：用
golang:alpine镜像测 musl 行为，用mcr.microsoft.com/dotnet/sdk:7.0（带 WSL2）临时跑 Windows 兼容性检查
平台特定代码不是越少越好，而是要让“平台差异”显式、隔离、可测。藏在 if-else 里的 OS 判断，比用构建标签拆成三个文件更难维护。
