Go测试文件必须与源码同包同目录，文件名以_test.go结尾；同包声明才能访问未导出标识符；go test默认不递归子目录，需用./...或显式路径；internal/等私有包的测试须置于对应目录内。
测试文件必须和源码文件同包同目录
Go 的测试文件不是独立模块，go test 要求测试文件与被测源码在同一个包（package 声明一致）、同一个目录下。否则编译失败或无法访问未导出标识符。
- 源码文件
utils.go声明package utils，测试文件必须也写package utils，不能写package utils_test（那是白盒测试的例外，见下条） - 测试文件名必须以
_test.go结尾，如utils_test.go；否则go test会直接忽略 - 如果测试需要访问源码中未导出的函数或字段（比如内部辅助函数），只能用同包测试——这时必须保持同包声明
想测未导出符号？别加 _test 后缀的包名
很多人误以为只要文件名带 _test.go 就能测私有成员，其实关键在包声明：只有当测试文件和源码**同包名**（比如都是 package main），才能直接调用未导出函数或读取未导出字段。
- 错误写法：
main_test.go里写package main_test→ 无法访问main包里的parseConfig()（小写） - 正确写法：
main_test.go里写package main→ 可直接调用parseConfig() -
package xxx_test是为“黑盒测试”设计的：只通过导出接口验证行为，隔离内部实现，适合集成测试或避免测试污染源码逻辑
go test 默认只跑当前目录，不递归子目录
执行 go test 时，它只查找当前目录下的 *_test.go 文件，并编译运行。子目录中的测试不会自动包含——哪怕子目录也有 go.mod 或同名包。
- 要测试整个模块：用
go test ./...（注意./...是通配语法，不是路径拼接） - 要测试特定子目录：显式指定路径，如
go test ./storage/、go test ./handlers/auth/ - 如果子目录是独立包（比如
internal/下的私有包），且测试文件在该目录内，必须用完整路径调用，go test不会向上查找
常见组织陷阱：internal/ 和 cmd/ 下的测试位置
internal/ 目录本意是限制外部导入，但测试文件放错位置会导致编译失败或权限绕过。
立即学习“go语言免费学习笔记（深入）”；
-
internal/utils/下的helpers.go（package utils），其测试必须放在同一目录：即internal/utils/utils_test.go，且声明package utils - 不能把测试提到根目录或
cmd/下——那样会因跨包无法访问internal中的类型，或触发 “use of internal package not allowed” 错误 -
cmd/myapp/main.go的测试也应放在cmd/myapp/目录下，而不是根目录；否则main函数可能被多次定义（尤其当你用go run .和go test混合操作时）
myproject/
├── go.mod
├── main.go # package main
├── main_test.go # package main ← 可测未导出符号
├── utils/
│ ├── helpers.go # package utils
│ └── helpers_test.go # package utils ← 同包测试
└── internal/
└── db/
├── connection.go # package db
└── connection_test.go # package db ← 必须在这里，不能挪到根目录实际项目里最容易漏掉的是子目录测试的显式路径调用，以及 internal/ 包测试文件的位置约束——这两处一错，go test 要么静默跳过，要么报错但提示模糊。
