go构建标签必须写在文件第一行且后跟空行才生效，推荐用//go:build integration（非旧式// +build），否则go test -tags=integration将找不到测试。
构建标签怎么写才生效
Go 的构建标签必须出现在文件第一行，且后面紧跟着一个空行，否则会被忽略。用 //go:build integration，不是 // +build integration（后者是旧语法，已弃用）。新旧混用或位置不对，go test -tags=integration 就完全找不到测试文件。
常见错误现象：
-
go test -tags=integration ./报no tests to run，但文件里明明有TestXxx函数 - 测试文件开头写了
// +build integration，但没加空行，导致构建标签失效 - 同一目录下既有
user_test.go（无标签），又有user_integration_test.go（带//go:build integration），但运行时不加-tags也跑出了集成测试——说明标签写错了，被当成普通测试文件处理了
集成测试文件命名要不要加 _integration_test.go
不强制，但强烈建议。Go 本身不靠文件名识别测试类型，只看构建标签和函数签名；但加后缀是团队协作的事实标准，能一眼区分用途，避免误删或误提交。
使用场景：
- CI 脚本里用
find . -name "*_integration_test.go"快速校验是否遗漏集成测试文件 - IDE 或编辑器插件按后缀高亮、折叠或过滤测试文件
- 新人看到
xxx_integration_test.go就知道不能随便在本地go test ./运行
注意：如果用了 _integration_test.go 后缀，仍必须加 //go:build integration，否则 go test -tags=integration 不会加载它。
为什么 go test 默认不跑集成测试
因为没显式启用对应构建标签。Go 的 go test 默认只编译和运行「没有构建标签」或「标签为空集」的文件。一旦文件顶部声明了 //go:build integration，它就变成条件编译文件，必须用 -tags=integration 才能进入编译流程。
参数差异：
-
go test ./→ 只跑xxx_test.go（无构建标签） -
go test -tags=integration ./→ 跑所有带//go:build integration的文件，**同时也会跑没标签的文件**（比如单元测试） -
go test -tags="integration unit"→ 无效，-tags是“满足任一标签即编译”，不是“同时满足”
性能影响：集成测试常连 DB、HTTP、Redis，单次运行可能耗时数秒甚至分钟；不隔离的话，日常开发 go test ./ 就卡住，CI 也会因超时失败。
集成测试里怎么安全访问数据库
硬编码 localhost:5432 是最常见翻车点。集成测试必须通过环境变量注入连接串，否则本地能跑、CI 里挂，或者不同人机器上端口冲突。
实操建议：
- 测试代码里统一读
os.Getenv("DB_URL")，不拼接字符串 - CI 中注入
DB_URL=postgres://test:test@localhost:5432/test?sslmode=disable - 本地开发时用
export DB_URL=...，或在 IDE 运行配置里设环境变量 - 每个集成测试开头加
if os.Getenv("DB_URL") == "" { t.Skip("DB_URL not set") }，避免报错后卡死
容易被忽略的地方：即使用了环境变量，也要在测试开始前调用 db.Ping() 确认连接可用。很多 CI 环境数据库服务启动慢于 Go 测试进程，直接 sql.Open 成功不代表能用，Ping() 才是真实探活。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
