本文介绍如何正确使用 go test 命令对 Go 项目中特定目录（如 handlers/）下的测试文件执行带详细日志的测试，解决 t.Log() 和 fmt.Println() 在测试中无输出、变量未定义等常见问题。
本文介绍如何正确使用 `go test` 命令对 go 项目中特定目录（如 `handlers/`）下的测试文件执行带详细日志的测试，解决 `t.log()` 和 `fmt.println()` 在测试中无输出、变量未定义等常见问题。
在 Go 测试中，若希望看到 t.Log() 或 fmt.Println() 的输出，必须启用详细模式（verbose mode），且需确保测试命令作用于正确的包路径——而非单个 .go 文件路径。
✅ 正确做法是：
go test ./handlers -v
该命令表示“对 handlers 目录所代表的 Go 包执行测试，并显示详细输出”。此时：
- t.Log("debug: branch reached") 会以 === RUN TestXXX 下的 --- PASS: 行之后清晰打印；
- fmt.Println("Hello from test") 也会同步输出（但注意：fmt 输出不带前缀，t.Log 更规范，推荐优先使用）；
- 所有测试函数（以 TestXxx 命名、接收 *testing.T 参数）将被自动发现并执行。
⚠️ 常见错误及原因：
- ❌ go test -run time_test.go：-run 参数匹配的是测试函数名正则（如 TestTimeParse），不是文件路径；传入文件路径会导致无匹配、静默通过。
- ❌ go test time_test.go：直接传 .go 文件会因缺失包声明、依赖未导入（如 handlers/time.go 中的类型未引入）而编译失败，报 undefined: XXX。
- ❌ go test -v time_test.go：同上，仍无法单独编译测试文件，Go 要求测试必须在完整包上下文中运行。
? 额外提示：
- 若只想运行某个具体测试函数，用 -run + 函数名：
go test ./handlers -v -run ^TestTimeParse$
- 想实时查看调试日志又不想每次敲 -v？可设别名：
alias gotest='go test -v'
- t.Log() 输出仅在测试失败或启用 -v 时显示；若需无论成败都强制输出（如性能调试），可用 t.Logf("elapsed: %v", time.Since(start)) 配合 -v。
总结：Go 测试本质是包级操作，不是文件级。始终使用 go test ./<dir> -v 启动测试，确保包结构完整、测试可编译、日志可观察——这是 Go 工程化调试的基石。
