go test能运行需满足：测试文件名以_test.go结尾、与被测代码同包、函数名以Test开头且参数为*testing.T；否则会静默忽略或报no test files。
go version 能正常输出，说明环境已就绪；但仅靠这个不能保证测试能跑通——很多新手卡在 GOPATH、GOBIN 或模块初始化上，导致 go test 找不到包或报 no test files。
验证 go test 是否真能工作
光有 go version 不够，得确认测试框架能识别并执行测试文件。常见失败现象是：运行 go test 后直接返回 no test files 或 cannot find package。
- 确保当前目录下有
*_test.go文件（不是.go，也不是test.go） - 测试文件必须和被测代码在同一个包里（
package main或package xxx一致） - 如果项目用了 Go Modules（推荐），需先在项目根目录执行
go mod init your-module-name，否则go test可能按旧 GOPATH 模式查找，路径错乱 - 用
go list ./...看是否能列出子包；若报错，说明模块未初始化或go.mod缺失
写第一个可运行的测试用例
不要从复杂逻辑开始，先让 go test 打印出 PASS。最容易踩的坑是函数签名不对、包名不匹配、或忘了 import "testing"。
- 测试函数名必须以
Test开头，且首字母大写：如TestAdd，不能是testAdd或add_test - 参数必须是
*testing.T，不能漏掉星号或写成testing.T - 被测函数和测试函数应在同一目录、同一包名下；若在
main包，测试也得写package main - 示例最小可运行测试：
// calc.go
package main
func Add(a, b int) int {
return a + b
}
// calc_test.go
package main
import "testing"
func TestAdd(t *testing.T) {
got := Add(2, 3)
want := 5
if got != want {
t.Errorf("Add(2,3) = %d, want %d", got, want)
}
}
然后在该目录下运行 go test，应输出 PASS。
go test 常见参数与误用点
go test 表面简单，但参数组合直接影响结果可信度。很多人只用默认命令，错过并发冲突、性能退化等真实问题。
立即学习“go语言免费学习笔记（深入）”；
-
go test -v：显示每个测试名和t.Log输出，调试必备；没加时失败只报错行号，难定位 -
go test -race：检测竞态条件（race condition），并发测试必须加，否则可能漏掉 goroutine 间数据竞争 -
go test -count=2：重复运行同一测试 2 次，暴露依赖全局状态或未清理资源的问题 - 避免
go test ./...在非模块根目录执行——可能跨包导入混乱，优先在go.mod所在目录运行
为什么 GOPATH 现在常被忽略？
Go 1.11+ 默认启用 Modules，GOPATH 对普通项目已非必需；但它仍影响 go install 和 go get 的行为，尤其当你想把二进制装到 $GOBIN 时。
- 若没设
GOBIN，go install会默认放到$GOPATH/bin；而现代习惯是直接go build -o ./bin/myapp -
GOROOT一般不用手动设——安装程序已写死；但若手动解压 Go 到非标准路径，必须导出GOROOT - 检查是否真用了 Modules：看目录下是否有
go.mod；若有，GOPATH就只是后备路径，不影响go test查找逻辑
真正容易被忽略的是 go mod tidy 后再跑测试——新增依赖没拉全时，go test 可能编译失败，而非报“找不到包”。
