Go语言如何跳过某些测试_测试条件控制方式说明_技术教程

Go测试中跳过特定用例需用t.Skip或t.Skipf在测试函数内调用；build tag用于编译期过滤文件；-run和-skip命令行参数支持运行时动态筛选；子测试中跳过仅影响当前case。

Go 测试中跳过特定测试用例（`testing.T.Skip`）

当某个测试在特定环境（如缺少依赖、非 Linux 系统、未配置密钥）下无法运行时，直接报错会干扰 CI 或本地验证。Go 原生支持在运行时主动跳过，而不是靠注释或条件编译屏蔽测试函数。

关键点是：跳过必须在测试函数内部调用 Skip 或 Skipf，且只能在 t 仍有效时调用（不能在 goroutine 中调用）。

t.Skip("reason")：立即终止当前测试，标记为 skipped（不报错、不计入失败）
t.Skipf("missing %s", "DB_URL")：带格式化参数的跳过提示
跳过发生在测试执行阶段，不影响其他测试；go test 输出中会显示 skip 而非 pass/fail
不能在 TestMain 或 init() 中调用 —— 那里没有 *testing.T

func TestDatabaseQuery(t *testing.T) {
	dbURL := os.Getenv("TEST_DB_URL")
	if dbURL == "" {
		t.Skipf("skipping DB test: TEST_DB_URL not set")
	}
	// ... actual test logic
}

按构建标签（build tag）控制测试文件是否参与编译

Build tag 是编译期过滤机制，适合完全隔离平台相关、竞态敏感或需额外依赖的测试文件。它比运行时跳过更彻底：被排除的文件根本不会进入编译和测试流程。

注意：tag 必须写在文件顶部，且与文件内容之间**空一行**；多个 tag 用空格分隔，表示“与”关系；用逗号分隔表示“或”关系（如 //go:build linux,arm64）。

文件开头添加：//go:build integration（Go 1.17+ 推荐语法），旧版用 // +build integration
运行时启用：go test -tags=integration；默认不启用任何 tag，所以该文件默认被忽略
常见组合：//go:build !race（禁用竞态检测时才包含）、//go:build windows（仅 Windows 编译）
错误写法：//go:build integration // wrong: no blank line after comment

//go:build integration

package main

import "testing"

func TestSlowExternalAPI(t *testing.T) {
	// only runs when `go test -tags=integration`
}

使用 `-run` 和 `-skip` 命令行参数动态筛选测试

go test 自带的过滤能力适用于临时调试，不修改代码。其中 -run 是正则匹配测试名（支持子测试嵌套路径），而 -skip（Go 1.22+ 引入）可排除匹配的测试，两者可共存。

go test -run=^TestHTTP：只运行以 TestHTTP 开头的测试函数
go test -run=TestAuth/valid：运行子测试 TestAuth 下名为 valid 的 case（需用 t.Run("valid", ...) 定义）
go test -skip=".*_broken$"：跳过所有以 _broken 结尾的测试名（包括子测试）
-run 和 -skip 同时存在时，先应用 -run 再对结果集应用 -skip
注意：正则中特殊字符如 .、$ 需转义或加引号，避免 shell 解析错误

子测试（`t.Run`）内条件跳过与复用逻辑

大型测试常拆分为多个子测试，便于定位失败点和独立跳过部分 case。子测试中调用 t.Skip 只影响当前子测试，不影响父测试或其他子测试。

容易出错的是：误在子测试外提前返回、或把跳过逻辑放在 for 循环外部导致整组跳过。

每个 t.Run 是独立生命周期，可在其内部自由调用 t.Skip、t.Fatal 等
推荐将跳过判断放在 t.Run 回调函数最开始，避免无谓初始化
若一组子测试共享前置条件（如环境变量检查），应在父测试中统一判断并跳过整个父测试，而非每个子测试重复判断

func TestConfigLoad(t *testing.T) {
	cfgPath := os.Getenv("TEST_CFG")
	if cfgPath == "" {
		t.Skip("TEST_CFG not set, skipping all config tests")
	}

	t.Run("valid_json", func(t *testing.T) {
		if runtime.GOOS == "windows" {
			t.Skip("JSON config test unstable on Windows")
		}
		// ...
	})

	t.Run("yaml_fallback", func(t *testing.T) {
		// no skip here
	})
}