阶段2(上):后端专题 Go/Gin/PostgreSQL/MySQL/Redis/MQ/gRPC 的课程、企业场景、面试题和可运行示例

This commit is contained in:
Shikui Wang committed 2026-10-23 15:24:57 +08:00
1 parent 0bae9916a9
commit 5eb67c5d08
65 files changed
+6457 -77

No files matched your search

+100
View File
@@ -0,0 +1,100 @@
---
id: backend.go.testing-engineering
title: 测试和工程化:表格驱动测试、httptest、模块、项目结构
type: lesson
domain: backend
stack: [go]
tags: [Go, 测试, httptest, go mod, 项目结构]
level: intermediate
prerequisites: [backend.go.basics-types]
est_hours: 3
related: [backend.go.interview, backend.gin.routing-binding]
week: [1, 2, 3]
order: 3
---
# 测试和工程化:表格驱动测试、httptest、模块、项目结构
## 解释说明
- **go test**:`xxx_test.go` 里的 `TestXxx(t *testing.T)` 会被自动执行。`t.Run` 定义子测试;`-race` 检测数据竞争;`-cover` 看覆盖率;`BenchmarkXxx` 做性能测试。
- **表格驱动测试**:把多组“输入 + 期望”写成切片循环执行,是 Go 社区的惯例,新增用例只加一行。
- **httptest**:`httptest.NewRecorder()` 不启动端口直接测 handler;`httptest.NewServer` 启动一个真实的本地服务,用来模拟第三方接口。
- **模块**:`go mod init 模块名` 生成 `go.mod`;`go get` 加依赖;`go mod tidy` 清理。`go.sum` 记录依赖的校验和,要提交。
- **项目结构**(社区常见做法,不是强制标准):`cmd/<程序名>/main.go` 放入口;`internal/` 放不希望被其他模块导入的代码(编译器强制);按职责分包(`handler`、`service`、`store`),避免一个 `utils` 包装所有东西。
## 案例
接口层的测试一般这样分:handler 测试用 `httptest.NewRecorder` + 内存版 store,覆盖参数校验、状态码、鉴权;store 的集成测试连真实数据库(没有数据库时跳过);调用第三方的代码用 `httptest.NewServer` 模拟各种返回(超时、500、格式错误)。
## 代码示例
```go
// 文件:slug.go
package slug
import (
"strings"
"unicode"
)
// Make 把标题转成 URL 片段:小写、空白和标点变成 -,去掉首尾 -
func Make(title string) string {
var b strings.Builder
dash := false
for _, r := range strings.ToLower(title) {
if unicode.IsLetter(r) || unicode.IsDigit(r) {
b.WriteRune(r)
dash = false
} else if !dash && b.Len() > 0 {
b.WriteByte('-')
dash = true
}
}
return strings.TrimSuffix(b.String(), "-")
}
```
```go
// 文件:slug_test.go
package slug
import "testing"
func TestMake(t *testing.T) {
cases := []struct {
name, in, want string
}{
{"普通", "Hello World", "hello-world"},
{"多个符号", "Go -- 并发!!", "go-并发"},
{"首尾空白", " Redis ", "redis"},
{"空", "", ""},
}
for _, c := range cases {
t.Run(c.name, func(t *testing.T) {
if got := Make(c.in); got != c.want {
t.Fatalf("Make(%q) = %q, want %q", c.in, got, c.want)
}
})
}
}
func BenchmarkMake(b *testing.B) {
for b.Loop() { // Go 1.24+ 的写法;旧版本用 for i := 0; i < b.N; i++
Make("Hello World From Go")
}
}
```
运行:`go mod init slug && go test -v -race -cover ./... && go test -bench=. ./...`
## 易错点
- 测试之间共享全局状态(全局 map、同一张表)会让测试结果依赖执行顺序;每个测试自己准备数据,`t.Cleanup` 清理。
- 只测“正常路径”:错误路径(参数错、下游失败、超时)才是线上出问题的地方。
- `internal` 包只能被它的父目录及子目录导入;别的模块导入会编译失败——这是故意的。
- 不提交 `go.sum` 会让别人构建时无法校验依赖。
## 面试常问
见 [Go 面试题](interview.md):怎么测试依赖数据库或第三方接口的代码、`internal` 的作用。