Go 中如何编写平台相关测试文件

Go 支持通过构建约束（build tags）实现测试文件的平台/架构条件编译，`*_windows_test.go` 等复合后缀不被识别，正确方式是在测试文件顶部添加 `// +build windows` 等约束注释，并确保其位于文件最上方（在 package 声明之前）。

在 Go 中，文件名后缀（如 _windows.go、_test.go）确实具有语义含义，但它们不支持组合叠加。这意味着 *_windows_test.go 或 _test_windows.go 这类命名方式不会生效——Go 的构建系统仅识别单一语义后缀，且构建约束与测试标识是正交机制，需显式声明。

✅ 正确做法：使用 Build Constraint（构建约束）
在测试文件顶部（必须严格位于 package 声明之前，且前面不能有空行或注释），添加如下格式的构建约束行：

// +build windows

package mypkg

import "testing"

func TestOnWindowsOnly(t *testing.T) {
    t.Log("This test runs only on Windows")
}

⚠️ 注意事项：

• 构建约束行必须以 // +build 开头（注意末尾空格），后接空格分隔的标签（如 windows、linux amd64、!darwin）；
• 多个约束可用换行并列，表示逻辑 OR；同一行内用空格分隔多个标签，表示 OR；用逗号连接（如 windows,amd64）表示 AND；
• 文件仍需保留 _test.go 后缀，否则 go test 不会识别为测试文件；
• 运行时需确保环境匹配约束：go test 默认会自动过滤满足当前 GOOS/GOARCH 的文件，无需额外参数；若需显式指定，可运行 GOOS=windows go test（注意：这会影响整个包的构建环境，包括非测试文件）。

? 示例：跨平台差异化测试
假设你有一个需在 Linux 上跳过、仅在 macOS 和 Windows 上运行的集成测试：

// +build darwin windows

// integration_test.go
package mypkg

import "testing"

func TestExternalServiceIntegration(t *testing.T) {
    // 仅在 macOS 或 Windows 下执行
}

? 总结：Go 不支持“多后缀组合”（如 _windows_test.go），但通过标准构建约束 + _test.go 命名，即可精准控制测试文件的平台/架构可见性。这是官方推荐、稳定可靠且被 go test 完全支持的方案。