testing.t.skip 必须在 func(t *testing.t) 内部调用，否则因 t 不存在或失效而 panic；它立即终止当前测试并标记为 skipped，不可在包级变量、init 或 defer 中使用，且子测试中调用只影响自身。
testing.T.Skip 为什么不能在测试函数外调用
testing.T.Skip 必须在 func(t *testing.T) 内部调用，否则会 panic。常见错误是把它放在包级变量初始化、init() 函数或测试函数外部的辅助函数里——这时 t 不存在或已失效，运行时会报 panic: runtime error: invalid memory address 或更明确的 testing: t.Fatal called without a *testing.T 类似提示。
它不是“标记跳过”，而是“立即终止当前测试并记录为 skipped”。所以它的执行位置决定了测试是否真的被跳过，而不是被忽略或静默失败。
- 只能在
func(t *testing.T) { ... }作用域内调用 - 一旦调用，该测试函数剩余代码不再执行（类似
return） - 不能用在
defer中——defer 执行时测试可能已结束，t不再有效
如何安全地检查环境条件再跳过
典型场景：测试依赖 Docker、特定环境变量、文件系统权限或外部服务。直接硬编码 t.Skip("missing docker") 不够健壮，应先验证条件再决定是否跳过。
推荐写法是把条件检查封装成返回 bool, string 的小函数，避免重复逻辑，也方便复用和测试。
func hasDocker(t *testing.T) (bool, string) {
t.Helper()
if _, err := exec.LookPath("docker"); err != nil {
return false, "docker not found in PATH"
}
out, _ := exec.Command("docker", "version", "--format", "{{.Server.Version}}").Output()
if len(out) == 0 {
return false, "docker daemon not responding"
}
return true, ""
}
func TestDockerDeploy(t *testing.T) {
if ok, reason := hasDocker(t); !ok {
t.Skip("skipping Docker test: ", reason)
}
// ... real test logic
}
-
t.Helper()让错误行号指向调用处而非辅助函数内部 - 不要用
t.Fatal替代t.Skip—— 前者让测试失败，后者才是“跳过”语义 - 避免只检查环境变量存在却不验证其值是否有效（例如
os.Getenv("API_URL") != ""不代表 URL 可访问）
testing.T.Skip 与 testing.T.SkipNow、testing.T.Skipf 的区别
三者行为一致：都终止当前测试并标记为 skipped，但参数和使用习惯不同。
-
t.Skip(msg ...interface{})：最常用，自动调用fmt.Sprint拼接消息，适合简单描述 -
t.Skipf(format string, args ...interface{})：需要格式化（如带变量值），比如t.Skipf("requires Go >= %s, got %s", minVer, runtime.Version()) -
t.SkipNow()：不带任何消息，仅跳过。极少单独使用，一般用于条件分支末尾兜底（但建议显式说明原因）
注意：t.Skip 和 t.Skipf 在传入空字符串或 nil 参数时仍会记录为 skipped，但无日志信息——这会让 CI 日志难以排查为何跳过，不推荐省略原因。
在子测试中调用 Skip 是否影响其他子测试
不影响。每个子测试（t.Run 启动的）有独立的 *testing.T 实例，t.Skip 只终止当前子测试，父测试和其他子测试照常运行。
func TestMatrix(t *testing.T) {
for _, tc := range []struct{
name string
mode string
}{
{"cpu", "cpu"},
{"gpu", "gpu"},
{"tpu", "tpu"},
} {
t.Run(tc.name, func(t *testing.T) {
if tc.mode == "gpu" && !hasNVIDIA() {
t.Skip("no NVIDIA GPU available")
}
// 其他模式继续执行
})
}
}
- “gpu” 子测试跳过，但 “cpu” 和 “tpu” 仍运行
- 如果想跳过整个
TestMatrix，必须在t.Run外判断并调用t.Skip - 子测试中调用
t.Skip后，不会触发该子测试内的defer（同主测试）
*testing.T，且作用范围严格限定在当前测试函数或子测试内。
