Go测试编译失败非逻辑错误，而是TestXxx未被识别，主因是_test.go文件名错误、包声明不匹配、函数签名不符（须func TestXxx(t *testing.T)）、或go.mod路径混乱；用go list ./...和go test -list=.可快速验证。
go test 编译失败，不是代码逻辑错，而是连 TestXxx 函数都没法被识别或加载——这通常卡在编译前的符号发现阶段。直接看报错信息里有没有 undefined: TestXxx、no buildable Go source files 或 cannot find package 这类提示，就能快速定位是结构问题还是环境问题。
测试文件名和包声明不匹配导致 no buildable Go source files
Go 要求 _test.go 文件必须和被测代码在**同一包内**（除非是外部集成测试），且不能用 package main（除非你真在测一个可执行程序）。常见错误包括：
- 把
user_test.go放在cmd/目录下，但里面写的是package user——go test扫不到这个包 - 测试文件用了
package main，但当前目录没有main.go，go test会拒绝构建 - 文件名拼错，比如
user_tests.go（少了个e）或user.test.go（点号分隔）——Go 只认_test.go后缀 - 文件在子模块外的路径，但
go.mod没覆盖到，go test当作普通目录跳过
验证方式：运行 go list ./...，确认该测试文件所属包是否出现在输出中；再执行 go test -v ./... 2>&1 | grep "user_test"，看是否被扫描到。
Test 函数签名或可见性错误引发 undefined: TestXxx
Go 测试驱动只识别符合严格签名的函数：func TestXxx(t *testing.T)。任何偏差都会让 go test 完全忽略它，最终报 undefined 或静默跳过。
- 参数名写成
tt *testing.T或t *testing.B—— 不行，必须是t *testing.T - 函数名首字母小写，如
func testLogin(t *testing.T)—— Go 不导出，go test看不见 - 漏掉
*testing.T参数，写成func TestLogin()—— 编译失败，报类型不匹配 - 测试函数在
init()里动态注册（像某些 mock 框架老写法）—— Go 原生测试不支持，会被跳过
小技巧：用 go test -list=. 查看当前包下所有被识别的测试函数名，如果空着，基本就是签名或可见性问题。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
go.mod 和模块路径混乱导致 cannot find package
当项目有嵌套模块、replace 或本地依赖时，go test 容易因模块解析失败而卡在 import 阶段。典型表现是报错里带 cannot find package "xxx"，但明明 go build 没问题。
-
go test默认以当前目录为模块根，若你在子目录执行，又没加-mod=mod，可能读错go.mod路径 - 被测代码 import 了
github.com/yourorg/pkg/internal/util，但测试文件在pkg/外，且没开replace或go.work，就会找不到 - 使用了
//go:build构建约束，但测试文件没加对应 tag（比如只写了//go:build !windows，却在 Windows 上跑）
解决优先级：先 go mod tidy，再 go test -mod=mod -v 显式指定模块模式；如果仍失败，临时加 -x 看 go test 底层调用的 go list 和 go build 命令，定位哪一步 resolve 失败。
第三方测试库（如 Ginkgo）未正确初始化引发 handler 注册失败
像 Ginkgo + ghttp 这类框架，不是靠函数签名被发现，而是靠全局 var _ = Describe(...) 注册。一旦结构写错，go test 能编译通过，但运行时无 handler，ghttp.Server 直接返回 500 —— 表面是 HTTP 错误，根源是测试没注册上。
-
It写在最外层，没包在Describe或Context里 —— Ginkgo 不注册，ghttp.Server收到请求后找不到 handler，返回 500 -
BeforeSuite里启动了 server，但AfterSuite没关，下次跑测试时端口被占，ghttp.NewServer()panic，整个测试进程退出 - 用了
ghttp.VerifyRequest("POST", "/api")，但实际请求是POST /api/（结尾斜杠），断言失败 → handler 被跳过 → 500
查法很简单：在 It 开头加一行 fmt.Println("running test")，如果没打印，说明根本没进测试块 —— 就是嵌套或注册问题。
go test 当作测试加载；函数名对、参数对，也不代表它真被框架注册。Ginkgo 的 500、Gomega 的静默失败、甚至 go test -v 里完全看不到测试名——这些都不是运行时 bug，而是测试生命周期的第一步就断了。 
