Go不支持直接排除文件，需用//go:build !tag或//go:build ignore配合-tags参数实现跳过；必须紧贴文件首行、后跟空行，否则约束失效。
用 //go:build 注释排除单个 Go 文件
Go 不支持像 Makefile 那样在构建时动态“删除”文件，但可通过构建约束（build tags）让 go build 主动忽略某些 .go 文件。关键不是“排除”，而是“不满足条件就不编译”。
在目标文件顶部添加形如 //go:build !linux 的注释（注意：空行不能少），该文件就只在非 Linux 环境下参与构建；若写成 //go:build ignore，再配合 -tags ignore，就能稳定跳过它。
-
//go:build后必须紧跟一个空行，否则被忽略 - 旧版用
// +build语法，已废弃，新项目统一用//go:build - 多个条件用空格分隔，如
//go:build !test && !debug，表示既不是 test 模式也不含 debug tag 时才编译
用 go:generate 配合脚本临时移除文件（慎用）
如果你真需要在构建前物理删掉某个文件（比如自动生成的桩代码、临时测试文件），可在 main.go 或构建入口加 //go:generate rm -f ./internal/stub/*.go，然后运行 go generate 再 go build。
但这不是标准构建流程的一部分，CI/CD 中容易遗漏 go generate 步骤，导致行为不一致。
立即学习“go语言免费学习笔记（深入）”；
-
go:generate不会自动触发，必须显式执行，go build默认不跑它 - Windows 下
rm不可用，得换del或用跨平台工具如golang.org/x/tools/cmd/stringer类方式封装 - 误删生产相关文件（如 embed 的模板）会导致静默失败，且 IDE 可能仍提示语法错误
模块级排除：用 replace 或子模块隔离不参与构建的代码
如果是一整组不希望进入最终二进制的文件（如集成测试工具链、文档生成器），更稳妥的做法是把它们拆到独立子模块（如 ./cmd/gen 或 ./tools），并在根 go.mod 中用 replace 或不引入其 import 路径。
Go 构建只会编译实际被 import 的包及其依赖，没被任何 import 引用的目录完全不会碰。
- 确保这些目录里没有
import "your-project/..."回指主模块，否则会意外拉入 - IDE（如 VS Code + gopls）可能仍索引这些文件，但
go build ./...不会包含它们 - 若用了
go.work，注意工作区配置可能让无关模块被主动加载
常见错误：误以为 .gitignore 或 go build -o /dev/null 能排除文件
.gitignore 只影响 Git，对 go build 完全无效；go build -o /dev/null 只是把输出丢弃，所有源文件仍会被解析、类型检查、编译——只要它在当前包路径下且满足构建约束。
- 错误现象：
go build报错说某个函数重复定义，其实是因为两个被“以为排除了”的文件都参与了构建 - 验证是否真被排除：运行
go list -f '{{.GoFiles}}' ./...，看输出里有没有那个文件名 - 最简排查法：临时改名文件为
xxx_ignore.go（Go 文件名不含.go后缀就不会被识别）
真正起作用的只有构建约束和导入路径控制。其他看似“排除”的操作，要么不生效，要么引入额外维护成本。尤其注意 //go:build 的空行规则和 tag 名称拼写——少个感叹号或空格，文件就会悄悄混进构建结果里。
