go build不支持--exclude参数，必须通过//go:build ignore（加空行）配合-tags=ignore，或移出包目录实现排除；双约束//go:build ignore与// +build ignore并存更兼容旧版。
go build 无法用 --exclude 跳过文件，必须靠构建约束或路径隔离
Go 的 go build 命令压根不支持 --exclude、-ignore 或类似参数。它只认两件事：包路径 + 构建约束（build tags）。所谓“忽略文件”，本质是让编译器“看不见它”——要么物理移走，要么用约束让它被逻辑排除。
最稳妥的实践是双保险：//go:build ignore 和 // +build ignore 并存（尤其兼容 Go 1.16 及更早版本），且两者后都必须紧跟一个空行。
- 把调试脚本、生成器（如
gen.go）留在包内？加双约束 + 空行，再配go build -tags=ignore - 想彻底杜绝误编译风险？直接挪到
./scripts/或./testdata/目录下——go build默认不扫描这些路径 - 别依赖文件名后缀（比如以为
xxx_dev.go就不会被编译），只有*_test.go在非测试命令中自动被跳过，其它后缀无此特权
// +build 和 //go:build 的写法差异与共存要点
// +build 是旧语法（Go 1.16 前主流），//go:build 是新语法（Go 1.17+ 推荐），二者可共存但有严格格式要求：必须都在文件最顶部、紧挨着 package 声明之前，且各自后必须有空行。
错误示例：// +build ignorepackage main —— 注释和 package 之间没空行，整个约束被当普通注释忽略；//go:build ignore// +build ignore —— 两约束挤在同一行或没空行，只生效一个甚至全失效。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 正确顺序（任选其一即可，双写更稳）：
//go:build ignore // +build ignore package main
- 验证是否生效：运行
go list -f '{{.GoFiles}}' ./，输出里不应出现该文件名；若还在，说明约束格式错或空行缺失 - CI/CD 中慎用
-tags=all—— 它会激活所有带标签的文件，包括你本想排除的ignore文件，应改用显式白名单，如-tags="linux sqlite"
构建标签逻辑容易踩的坑：空格、逗号、!NOT 的优先级
构建标签不是简单字符串匹配，而是布尔表达式：space 表示 OR，, 表示 AND，! 表示 NOT。但它的解析顺序和括号支持有限，复杂逻辑极易出错。
比如 // +build linux darwin,!cgo 实际等价于 (linux OR darwin) AND !cgo；而 // +build linux,386 darwin,amd64 是 (linux AND 386) OR (darwin AND amd64)。
- 避免嵌套否定：
// +build !windows,!darwin比// +build !windows darwin更易读且不易歧义 - 平台后缀（如
_linux.go）和构建标签是并列条件，任一不满足即排除——server_linux.go里写// +build !linux，在 Linux 上也绝不会被编译 - 测试文件中用标签控制执行时，同样要空行；否则
go test会照常编译并运行它，哪怕没传-tags
为什么 gen.go 总报 undefined 错误？根本原因是没加构建约束
很多项目把代码生成逻辑写在 gen.go 里，顶部只加了 //go:generate，却忘了加构建约束。结果 go build 尝试编译它，但里面引用的类型可能还没生成，或依赖未安装的工具，直接报 undefined: XXX 或 cannot find package。
- 必须在
gen.go第一行（且 package 前）加上//go:build ignore和空行，确保它永远不参与构建 - 生成操作仍可用：
go generate ./...会识别//go:generate指令，不受构建约束影响 - 如果生成逻辑需复用某些包内类型，又不想拆出包外，可在
gen.go里用// +build ignore+ 空行，并确保生成目标文件（如zz_generated.go）用//go:generate声明，而非手动 import
