使用 `go test -run @` 可快速验证 go 包及其测试代码的编译正确性，既不运行任何测试函数，也不留下临时二进制文件，是 ci/cd 和本地开发中轻量级构建检查的理想方案。
在 Go 开发中，经常需要确认代码（包括 _test.go 文件）能通过编译，但又不想触发实际测试执行（避免副作用、耗时或依赖环境），也不希望生成并残留测试二进制（如 foo.test）。此时，go test -run @ 是最简洁、标准且可靠的解决方案。
该命令的原理在于：
- go test 默认会编译包源码 + 测试源码 → 链接生成临时测试二进制 → 执行匹配 -run 的测试函数；
- -run @ 指定一个永远不匹配任何测试函数名的正则表达式（@ 在 Go 测试函数命名规范中不会出现，且 testing 包对 -run 值做严格正则匹配）；
- 因此，编译和链接阶段照常完成，但进入执行阶段后立即退出——零测试运行，无副作用，临时二进制在进程退出后自动清理（Go 1.16+ 默认启用 -work 临时目录自动清理）。
✅ 正确用法示例：
# 验证当前包（含所有 *_test.go） go test -run @ # 验证指定包（支持多包） go test -run @ ./pkg/... # 静默模式（仅输出错误） go test -run @ -v=false
⚠️ 注意事项：
- 不要使用 go build ./... 或 go list -f '{{.ImportPath}}' ./... 替代——它们无法编译测试文件，会遗漏 xxx_test.go 中的语法错误或类型问题；
- 避免 go test -c：虽可生成二进制，但需手动清理（如 rm *.test），不符合“不创建持久二进制”的要求；
- -run 参数必须为有效正则表达式（@ 安全，而空字符串 "" 或 .* 可能意外匹配测试）；
- 若需同时检查 go:generate 是否就绪，应额外搭配 go generate -n（dry-run 模式）。
总结：go test -run @ 是 Go 官方推荐的“编译时验证测试可构建性”的黄金实践——零配置、零残留、高可靠性，建议集成到 pre-commit 钩子或 CI 构建流水线的第一步。
