摘要：Go 语言的单元测试依赖于特定的命名约定。本文通过一个实际案例，解释了为何命名不规范的测试函数会被 go test 命令忽略，导致测试始终通过的现象。文章详细阐述了测试函数命名的规则，并提供了正确的示例代码，帮助开发者编写有效的 Go 单元测试。
Go 语言的 go test 命令是进行单元测试的关键工具。然而，开发者在使用过程中可能会遇到一些问题，例如测试代码明明写了错误，但 go test 却总是显示通过。这通常是由于测试函数命名不规范导致的。
测试函数命名规范
Go 语言的 go test 命令会查找符合特定命名规则的函数作为测试函数。这个规则非常严格，任何不符合规则的函数都会被忽略。根据官方文档，测试函数必须满足以下条件：
- 函数名以 Test 开头。
- Test 之后的第一个字母必须大写。
- 函数签名必须是 func TestXXX(t *testing.T) { ... }，其中 XXX 可以是任何字母数字字符串，但首字母不能是小写。
问题分析
在提供的案例中，测试函数被命名为 SumTest。虽然函数名包含了 Test，但是 Test 之后紧跟的是小写字母 s，因此 go test 认为它不是一个有效的测试函数，从而忽略了它。即使函数体内部使用了 t.Errorf 报告了错误，go test 也不会执行这个函数，因此总是显示测试通过。
要解决这个问题，只需将测试函数名修改为符合规范的形式。例如，可以将 SumTest 修改为 TestSum。修改后的代码如下：
package math
import "testing"
func TestSum(t *testing.T) {
t.Errorf("ssss %d", 1)
}现在，如果运行 go test example/math，就会看到测试失败，因为 t.Errorf 被执行了。
示例代码
下面提供一个更完整的例子，展示如何编写一个简单的加法函数并进行单元测试：
// math.go
package math
func Sum(a, b int) int {
return a + b
}// math_test.go
package math
import "testing"
func TestSum(t *testing.T) {
result := Sum(2, 3)
expected := 5
if result != expected {
t.Errorf("Sum(2, 3) returned %d, expected %d", result, expected)
}
}
func TestSumNegative(t *testing.T) {
result := Sum(-2, 3)
expected := 1
if result != expected {
t.Errorf("Sum(-2, 3) returned %d, expected %d", result, expected)
}
}在这个例子中，我们定义了一个 Sum 函数，并编写了两个测试函数 TestSum 和 TestSumNegative 来验证其正确性。
注意事项
- 务必仔细检查测试函数的命名，确保符合 TestXXX 的规范。
- 可以使用 go test -v 命令来查看更详细的测试输出，包括被忽略的测试函数。
- 养成良好的测试习惯，编写充分的测试用例，覆盖各种边界情况和异常情况。
总结
Go 语言的单元测试是保证代码质量的重要手段。理解测试函数命名的规范是编写有效测试用例的基础。通过本文的讲解，希望读者能够避免因命名问题导致的测试被忽略的情况，编写出高质量的 Go 代码。记住，Test 开头，首字母大写，是 Go 单元测试的关键。
