Go测试如何只运行指定用例_Go测试筛选技巧

5次阅读

最直接方式是用 go test -run 参数配合正则匹配函数名,如 go test -run ^TestLogin$ 严格匹配 TestLogin 函数,支持子测试路径式匹配如 TestLogin/valid,推荐搭配 -v 和 -failfast 调试。

Go测试如何只运行指定用例_Go测试筛选技巧

Go 测试中想只跑某个用例,不用改代码、不依赖 ide,最直接的方式是用 -run 参数配合正则匹配函数名。

go test -run 精确匹配测试函数名

Go 的 go test 命令原生支持通过 -run 过滤测试函数,它接收一个正则表达式,匹配 func TestXXX(t *testing.T) 中的 XXX 部分(不含 Test 前缀)。

常见用法:

  • go test -run TestLogin → 匹配 TestLoginTestLoginWithToken(因为 TestLogin 是子串)
  • go test -run ^TestLogin$ → 严格匹配仅名为 TestLogin 的函数(^$ 是正则锚点)
  • go test -run TestLogin.*Error → 匹配 TestLoginInvalidPasswordErrorTestLoginNetworkError
  • go test -run 'TestLogin|TestLogout' → 同时运行两个用例(注意 shell 中单引号防展开)

避免被子测试(subtest)干扰

如果用了 t.Run() 定义子测试(如 t.Run("valid input", ...)),-run 默认只匹配顶层测试函数名,不会自动进入子测试——除非你显式写出完整路径。

要运行某个子测试,必须带上父测试名和斜杠分隔:

  • go test -run TestLogin/valid → 运行 TestLogin 下名称含 valid 的子测试
  • go test -run 'TestLogin/valid input' → 子测试名含空格时需加引号
  • go test -run TestLogin/.+ → 运行 TestLogin 下所有子测试(. 在正则中匹配任意字符)

注意:-run 对子测试的匹配是“路径式”的,不是纯正则;斜杠 / 是固定分隔符,不能省略或替换为其他符号。

配合 -v-count=1 提升调试效率

单独跑一个用例时,加上这几个参数能更快定位问题:

  • -v:输出每个测试的名称和日志(否则静默成功时看不到任何输出)
  • -count=1:禁用默认的重复运行(Go 1.21+ 默认 -count=1,但老版本可能缓存结果,显式指定更稳妥)
  • -failfast:遇到第一个失败就停,适合快速验证修复效果
  • go test -v -run ^TestLogin$ -failfast 是日常调试的高频组合

别踩这些坑

实际用的时候容易卡住的地方:

  • 函数名拼错或大小写不对:TestloginTestLogin,Go 测试函数必须导出(首字母大写)
  • 忘记转义特殊字符:比如测试名含括号 TestParse(t *testing.T),写 -run TestParse() 会被 shell 当作命令执行,应写成 -run 'TestParse()' 或改用 TestParse 这类无特殊字符的命名
  • 在模块外执行:go test 必须在包含 *_test.go 的目录下运行,或用 go test ./... 指定包路径
  • 误以为 -run 支持模糊文件匹配:它只匹配函数名,不识别文件名或目录,go test -run foo file_test.go 是非法用法

真正需要按文件筛选时,得换用 go test file_test.go(但会跳过同包其他测试文件,慎用)。

text=ZqhQzanResources