Go测试跳过用例方法详解

t.Skip() 和 t.Skipf() 是 Go 中安全跳过测试的首选方式，需在 testing.T 方法体内调用，调用后自动 return；命令行 -skip（Go 1.22+）或 -run 配合正则可临时过滤；testing.Short() 适合控制耗时测试；build tag 实现编译期排除。

t.Skip() 和 t.Skipf()：运行时跳过测试的正确姿势

在测试函数里调用 t.Skip() 或 t.Skipf() 是 Go 中最常用、也最安全的跳过方式——它不会报错，不中断整个测试套件，只标记当前测试为 skipped，并如实出现在测试报告末尾的 summary 里。

• 必须在 *testing.T 方法体内调用，不能放在 goroutine 里（否则 panic：“t.called from wrong goroutine”）
• t.Skip("reason") 输出纯字符串；t.Skipf("env %s not ready", os.Getenv("DB_URL")) 更适合带动态值的场景
• 调用后自动 return，后面代码不执行，不用再写 return
• 常见误用：在 setup 函数或 defer 里调用 —— 此时 t 已失效，会静默失败或 panic

-run 和 -skip：命令行过滤，改代码前先试试

想临时绕过几个测试？别急着加 t.Skip()，先用命令行开关更干净。Go 1.22+ 原生支持 -skip，旧版本靠 -run 配合负向正则也能搞定。

• go test -skip="TestLegacy|TestE2E" —— 直接跳过匹配名称的测试（Go 1.22+）
• go test -run='^(?!TestIntegration).*' —— 在 bash/zsh 下排除集成测试（注意单引号防 shell 展开）
• go test -run=TestLogin —— 只跑一个，相当于“跳过其余全部”，适合快速验证
• ⚠️ -skip 不支持通配符（如 Test*），只能是正则；写错正则会导致“一个没跳过”或“全跳了”

结合 testing.Short() 控制耗时测试

CI 或日常开发中想快速过一遍核心逻辑？用 testing.Short() + t.Skip() 是标准解法。它不是魔法开关，而是靠你主动检查并跳过。

• 在测试开头加 if testing.Short() { t.Skip("skipping in short mode") }
• 然后用 go test -short 运行，所有含该逻辑的测试都会被跳过
• 适合网络请求、数据库操作、大文件读写等 I/O 密集型测试
• 别忘了在 CI 脚本里区分阶段：dev 环境跑 -short，release 流水线去掉该 flag

Build tag 编译期排除：跨平台/环境不兼容的硬隔离

有些测试天生就不该出现在某些系统上，比如 Windows 上调用 fork()，或 macOS 上访问 Linux 特有 procfs。这时候 runtime 判断太晚，得从编译源头剔除。

• 在测试文件顶部加 //go:build !windows（注意空行），再加 // +build !windows（兼容老版本）
• 文件名保持 xxx_test.go，但只有非 Windows 构建时才会被 go test 扫描到
• 比 t.Skip() 更彻底：完全不编译、不加载、零开销
• ⚠️ 容易踩坑：build tag 写错（比如漏了 ! ）、没加空行、或和 package 声明之间夹了注释，都会导致 tag 失效

真正难的不是“怎么跳过”，而是判断“该不该跳过”——跳过太多，覆盖率虚高；跳过太少，CI 动不动红。建议把所有 t.Skip() 的 reason 都写进内部文档，每季度扫一遍，删掉那些“早就该修好”的跳过项。