go条件编译依赖文件名后缀（如_linux.go）实现文件级静态裁剪，优先级高于//go:build注释，仅当goos/goarch匹配时才参与构建；_unix.go无效，须用显式约束或分文件；交叉编译依目标环境变量匹配后缀。
Go条件编译靠的是文件名后缀，不是import语句里的逻辑判断
Go没有像C/C++那样的#ifdef机制，也不支持在import或go.mod里按平台过滤依赖。所谓“特定平台的条件编译”，实际是通过文件命名约定让Go build工具自动排除不匹配的文件——依赖本身仍需在go.mod中声明，但对应平台的代码不会被编译进去。
文件名必须严格遵循_GOOS_GOARCH.go或_GOOS.go格式
这是Go build最核心的识别规则，错一个字符（比如多下划线、大小写错误、顺序颠倒）都会导致该文件被所有平台编译，或被全部忽略。
-
http_client_linux.go→ 仅Linux平台参与编译 -
http_client_darwin_arm64.go→ 仅macOS on Apple Silicon参与编译 -
http_client_windows_test.go→ Windows + test模式（注意：_test.go后缀优先级高于平台后缀，会先被识别为测试文件） - 错误写法：
http_client.linux.go（点号不合法）、http_client_LINUX.go（GOOS必须小写）、linux_http_client.go（顺序反了，会被所有平台加载）
平台相关依赖不能只靠条件编译文件，还要配合//go:build约束
仅靠文件名后缀无法控制第三方包的导入行为。如果你在http_client_linux.go里用了import "golang.org/x/sys/unix"，而该包在Windows上根本不可用，那么即使文件没被Windows编译，go list -deps或go mod tidy仍可能报错。这时必须加构建约束注释：
//go:build linux // +build linux package client import "golang.org/x/sys/unix"
注意两点：
-
//go:build和// +build必须同时存在（Go 1.17+推荐前者，但为兼容旧版本建议共存） - 构建标签之间用空行分隔，不能写成
//go:build linux && amd64——Go不支持&&，要用空格：//go:build linux amd64 - 如果依赖只在某平台需要，就不要把它放到通用
go.mod里；而是把平台专用代码和对应require放在独立模块，或用replace临时指向本地路径（慎用）
交叉编译时容易漏掉非目标平台的构建失败
本地开发通常只测当前GOOS/GOARCH，但CI里跑GOOS=windows GOARCH=386 go build时，可能暴露出Linux专属文件里误写的Windows不兼容API，或者构建约束漏写。
- 每次新增平台文件，务必在对应目标平台上执行完整构建：
GOOS=linux GOARCH=arm64 go build ./... - 检查
go list -f '{{.Deps}}' ./...输出，确认非目标平台的依赖没出现在结果里 - 若某个包确实只供单平台使用，且无法避免import（如封装了跨平台接口），可用
var _ = unix.Syscall这类“假引用”触发链接期报错，比运行时报错更早暴露问题
平台条件编译不是开关，是文件粒度的静态裁剪；真正要隔离依赖，得靠构建约束+模块拆分+CI多平台验证，少一个环节都容易在上线后崩。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
