go不支持跨平台“一次编译、到处测试”，必须在各目标平台环境（如github actions多平台runner或容器）中分别执行go test；平台相关逻辑需用构建标签和接口抽象隔离，避免panic。
Go 本身不支持跨平台“一次编译、到处测试”，但可以通过 GOOS 和 GOARCH 环境变量控制构建目标，再结合测试运行逻辑实现多平台自动化验证——关键不是让测试“在 Windows 上跑 Linux 代码”，而是让同一套测试逻辑，在不同平台的 Go 运行时下分别执行。
go test 默认只在当前 GOOS/GOARCH 下运行，不会自动跨平台
很多人误以为 go test 能像构建那样加 -o 输出多平台二进制一样“跑多平台测试”。实际上：go test 总是在当前宿主环境（runtime.GOOS/runtime.GOARCH）下编译并执行测试代码，它不模拟、不交叉运行。
- 你在 macOS amd64 上执行
go test，测的就是 macOS amd64 的行为 - 想验证 Windows 行为？必须在 Windows 环境（或 GitHub Actions 的
windows-latestrunner）中运行go test - 想验证 arm64 逻辑（比如文件权限、syscall 行为差异）？得在真机或对应架构 CI 环境里跑
所谓“多平台自动化测试”，本质是：用统一的测试代码 + 多个平台的 CI job 并行执行 go test。
CI 中配置多平台 job 必须显式指定 GOOS/GOARCH，且不能只靠环境变量
仅设置 GOOS=linux 不足以让 macOS 本地跑出 Linux 行为——Go 编译器会拒绝在非目标平台启用某些 syscall 或构建标签。真正生效的方式是：
- GitHub Actions 中用 matrix 策略启动多个 runner：
os: [ubuntu-latest, windows-latest, macos-latest] - 每个 job 内部无需手动设
GOOS—— Actions runner 自带对应平台的 Go 环境，go version输出已体现linux/amd64等标识 - 若需测试特定架构（如 linux/arm64），要用
runs-on: ubuntu-22.04-arm64或container指定 arm64 镜像，不能靠GOARCH=arm64在 x86 机器上“假装” -
GOOS/GOARCH只影响go build和go run；go test仍依赖当前 runtime，所以跨平台测试必须跨环境
平台相关逻辑必须用构建标签 + 条件编译隔离，否则测试会 panic
直接调用 syscall、读写 /proc、依赖 os.UserHomeDir() 返回格式等，都会在不同平台表现不一。不处理就会出现：
- Windows 上测试 panic：
invalid argument（因用了 Linux-only syscall） - macOS 上
os.OpenFile("x", os.O_CREATE|os.O_EXCL, 0)成功，Linux 下失败（umask 影响） - 测试里硬编码路径分隔符
"\"，在 Unix 系统下路径拼接错误
正确做法是用构建标签 + 接口抽象：
// file_linux.go
//go:build linux
package main
func getProcPath() string { return "/proc/sys/kernel/osrelease" }
// file_windows.go
//go:build windows
package main
func getProcPath() string { return "C:\Windows\System32" }
测试函数里只调 getProcPath()，不直接写死路径；所有平台敏感操作都走这种抽象层。
本地开发时如何快速验证多平台行为？别模拟，用容器或 WSL
开发者常想“我在 macOS 上怎么测 Windows 路径逻辑？”——答案不是写条件判断绕过，而是：
- 用
docker run --rm -v $(pwd):/app -w /app golang:1.21-alpine go test -v ./...测 Linux 行为 - Windows 用户开 WSL2，直接在里面跑
go test - 避免用
GOOS=windows go test：它只会报错cannot use windows-specific function，不帮你跳过 - 测试中创建临时目录一律用
t.TempDir()（Go 1.16+），它自动适配各平台路径规则和清理机制
平台差异最大的其实是 I/O、信号、进程管理、文件锁这几块，这些地方一旦没抽象，CI 里失败时日志里根本看不出是哪个平台出的问题——所以第一反应不该是“怎么让测试通过”，而是“这个逻辑是否真的需要跨平台一致”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
