最常见原因是_test.go文件中未定义以test开头、接收*testing.t参数的函数；必须确保测试函数名正确、签名合规、与被测代码同包，且文件名含_test.go后缀。
go test 命令怎么跑起来就报错？
最常见的是没在 _test.go 文件里写测试函数，或者函数签名不对。Go 要求测试函数必须以 Test 开头、接收单个 *testing.T 参数、且定义在和被测代码同一包内（或 xxx_test 包用于黑盒测试）。文件名不带 _test.go 后缀，go test 直接忽略。
运行时默认只执行当前目录下所有 *_test.go 中的 Test* 函数：
go test
加 -v 可看到每个测试函数名和结果：
go test -v
- 如果提示
no Go files in ...，检查是否在正确的模块根目录或含.go文件的子目录下执行 - 如果测试函数名是
testFoo或TestFoo()但参数不是*testing.T，会报missing argument类错误 -
go test不会自动编译或运行main函数，也不加载init()以外的副作用逻辑——这点和手动运行程序不同
如何给一个函数写最简可用的单元测试？
假设你有一个计算两个整数和的函数：
func Add(a, b int) int {
return a + b
}
对应测试应放在同目录下的 math_test.go 中：
func TestAdd(t *testing.T) {
got := Add(2, 3)
want := 5
if got != want {
t.Errorf("Add(2, 3) = %d, want %d", got, want)
}
}
- 别用
fmt.Println或log.Print输出断言失败信息，必须调用t.Error/t.Errorf，否则go test不认为这是失败 - 测试名推荐用
Test<code>前缀 + 被测函数名，便于定位 - 简单场景用
if判断足够；复杂结构建议用reflect.DeepEqual比较切片或 map，但注意它不比较函数、channel 等不可比较类型
测试中怎么模拟依赖（比如 HTTP 请求或数据库）？
Go 原生不提供 mock 框架，主流做法是「面向接口重构 + 依赖注入」。例如被测函数依赖一个获取用户数据的服务：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
type UserService interface {
GetUser(id int) (*User, error)
}
func ProcessUser(svc UserService, id int) error {
u, err := svc.GetUser(id)
if err != nil {
return err
}
// ...
return nil
}
测试时传入一个实现该接口的 fake 结构体：
type mockUserService struct{}
func (m mockUserService) GetUser(id int) (*User, error) {
return &User{Name: "test"}, nil
}
func TestProcessUser(t *testing.T) {
err := ProcessUser(mockUserService{}, 123)
if err != nil {
t.Fatal(err)
}
}
- 不要在测试里直接改全局变量或重写函数（如 monkey patch），Go 的静态链接模型会让这类操作不可靠
- 第三方库如
gomock或testify/mock可生成 mock，但多数小项目手写 fake 更轻量、更可控 - HTTP 服务测试优先用
httptest.Server起一个真实但可控的本地服务，而不是 mockhttp.Client
为什么 go test -race 一开就 panic？
-race 是 Go 内置的数据竞争检测器，它会在并发读写同一内存地址时立即报错。典型触发场景包括：
- 多个 goroutine 同时写一个未加锁的全局变量（如
var counter int） - map 在并发读写时没加
sync.RWMutex或没使用sync.Map - 测试中用
time.AfterFunc或goroutine启动异步逻辑，但没等它结束就退出测试函数
修复方式不是关掉 -race，而是补上同步原语：
var mu sync.RWMutex
var data map[string]int
func GetData(key string) int {
mu.RLock()
defer mu.RUnlock()
return data[key]
}
另外注意：go test -race 会显著拖慢执行速度，日常开发可定期跑，CI 中建议固定开启。
真正难调试的不是报错本身，而是竞争发生在测试的边界条件里——比如只在某个 goroutine 调度顺序下才出现。这时候得靠 -race 输出的堆栈定位具体行号，再检查那行是否真的被多线程共享访问。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
