如何在 Go 中编写待办测试（Pending Tests）

Go 语言虽无原生“pending test”语法，但可通过 t.Skip() 显式跳过未实现的测试，并在详细模式（-v）下清晰标记为待办，实现类似 Mocha 的 pending 行为。

Go 语言虽无原生“pending test”语法，但可通过 `t.Skip()` 显式跳过未实现的测试，并在详细模式（`-v`）下清晰标记为待办，实现类似 Mocha 的 pending 行为。

在 Go 的测试生态中，虽然没有像 JavaScript 测试框架（如 Mocha、Jest）那样提供 it.skip() 或 xit() 这类语义化的“待办测试”声明方式，但标准库 testing 包提供了完全等效且更可控的机制：使用 t.Skip() 在测试函数开头主动跳过执行，并附带可读性强的说明信息。

这种方式不仅合法、稳定，而且被 Go 官方文档明确推荐。例如：

func TestUserAuthentication(t *testing.T) {
    t.Skip("TODO: implement authentication flow with OAuth2")

    // 后续将在此处添加断言和逻辑
    // user, err := Authenticate("test@example.com", "secret")
    // if err != nil {
    //     t.Fatal(err)
    // }
    // if user.ID == "" {
    //     t.Error("expected non-empty user ID")
    // }
}

运行 go test -v 时，该测试会显示为 skipped，并输出你指定的提示信息：

=== RUN   TestUserAuthentication
--- SKIP: TestUserAuthentication (0.00s)
    user_test.go:12: TODO: implement authentication flow with OAuth2

✅ 最佳实践建议：

• 始终将 t.Skip() 放在测试函数第一行，确保跳过逻辑不被意外绕过；
• 使用一致的前缀（如 "TODO:" 或 "PENDING:"）便于后续批量搜索与清理；
• 避免在 Skip() 后编写实际测试逻辑——Go 不会执行跳过后的代码，但保留它易引发误解；
• 结合 go test -v -run=^TestUserAuthentication$ 可单独验证跳过行为是否生效。

值得注意的是，t.Skip() 不同于 t.Fatal() 或 t.Error()：它不会导致测试失败，也不会影响整体测试通过率，而是将该测试归类为“跳过项”，并在 -v 模式下明确呈现其意图——这正是“待办测试”的本质：已声明、暂不执行、意图清晰、可追溯。

因此，与其等待语言特性支持，不如善用 t.Skip() 构建轻量、规范、可协作的测试规划流程——它既是占位符，也是契约，更是团队间关于测试进度的透明信号。