Go测试代码不会被编译进生产二进制，因go build默认完全忽略*_test.go文件；测试文件须与被测代码同包同目录才能访问私有标识符；应使用-build标签、-run参数和testing.Short()控制执行，数据文件放testdata子目录并注意跨平台换行符。
Go测试代码会不会被编译进生产二进制？
不会。go build 默认完全忽略 *_test.go 文件，只要文件名符合 Go 测试命名规范（以 _test.go 结尾），就不会参与构建。这是 Go 工具链的硬性规则，不是靠约定或文档约束——连 AST 解析阶段都不会加载这些文件。
验证方式很简单：
go list -f '{{.GoFiles}} {{.TestGoFiles}}' ./... 可以看到 TestGoFiles 列出的文件永远不会出现在最终二进制里。
测试文件放在哪里才安全？
必须和被测代码在同一个包内（即同目录、同 package 声明），否则无法访问未导出标识符（如 func helper() {}），而单元测试往往需要测这些内部逻辑。
常见误操作：
立即学习“go语言免费学习笔记（深入）”；
- 把测试放到
test/子目录并声明package test—— 这会变成独立包，测不了原包私有函数 - 用
//go:build ignore或// +build ignore标记测试文件 —— 多余，且可能干扰go test发现测试 - 在
main包里写测试时混用func TestMain和func main—— 会导致构建失败，go test会拒绝运行
如何控制哪些测试在 CI/本地运行？
靠 -run、-short 和构建标签（build tags）组合控制，而不是删文件或改目录结构。
go test -run ^TestHTTP$ 只跑名字匹配正则的测试；go test -short 会让 if testing.Short() { t.Skip() } 生效，跳过耗时或依赖外部服务的测试。
对集成类测试，推荐加构建标签：
//go:build integration
package mypkg
func TestAPICall(t *testing.T) { ... } 然后 CI 里用 go test -tags=integration ./... 显式启用。
测试依赖的数据文件怎么管理？
放在测试文件同目录下，用 filepath.Join("testdata", "config.json") 加载，不要用绝对路径或向上跳级（../）。go test 会自动把当前包目录设为工作目录，所以相对路径是稳定的。
注意两点：
- 别把大文件（如 100MB 日志样本）直接塞进 Git —— 放到 CI 下载步骤中解压更合理
- 测试里读文件前务必检查
os.IsNotExist(err)，避免因文件缺失导致 panic 而不是清晰的t.Fatal - 如果多个测试共用同一份数据，考虑用
sync.Once预加载，而非每次打开文件
真正容易被忽略的是：测试文件的权限和换行符。Windows 上生成的 CRLF 数据文件，在 Linux CI 中可能导致 JSON 解析失败，这类问题不会报“文件不存在”，而是报“invalid character 'r' after object key”，得看清楚错误位置再排查。
