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

Go 测试中想只跑某个用例,不用改代码、不依赖 IDE,最直接的方式是用 -run 参数配合正则匹配函数名。
用 go test -run 精确匹配测试函数名
Go 的 go test 命令原生支持通过 -run 过滤测试函数,它接收一个正则表达式,匹配 func TestXXX(t *testing.T) 中的 XXX 部分(不含 Test 前缀)。
常见用法:
-
go test -run TestLogin→ 匹配TestLogin、TestLoginWithToken(因为TestLogin是子串) -
go test -run ^TestLogin$→ 严格匹配仅名为TestLogin的函数(^和$是正则锚点) -
go test -run TestLogin.*Error→ 匹配TestLoginInvalidPasswordError、TestLoginNetworkError -
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是日常调试的高频组合
别踩这些坑
实际用的时候容易卡住的地方:
- 函数名拼错或大小写不对:
Testlogin≠TestLogin,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(但会跳过同包其他测试文件,慎用)。










