在 xxx.go 文件开头添加代码//go:build debug
✅ 不加 //go:build debug 的文件 → 永远会被编译（默认行为）
✅ 加了 //go:build debug 的文件 → 「默认不编译」，只有运行编译命令时手动加-tags debug才会编译
通俗解释
- 加了这个注释的文件，默认是被忽略的，生产打包go build/go run 完全不会包含它；
- 只有写命令：
go run -tags debug xxx.go或go build -tags debug xxx.go，这个文件才会被编译进去； - 反向用法：
//go:build !debug→ 意思是「只有不加 debug 标签编译时，这个文件才生效」,注意有个!
例如
情况 1：你的文件第一行写了 //go:build debug
- 执行
go run main.go→ 这个文件不参与编译（被跳过） - 执行
go run -tags debug main.go→ 这个文件参与编译
情况 2：你的文件没写这个注释
- 不管执行
go run main.go还是go run -tags debug main.go→ 都会编译这个文件
使用vscode系列编辑器时，用到了 gopls 语言服务器，默认会报下面的警告提示
No packages found for open file D:\site\zero-core\search\tree_debug.go. This file may be excluded due to its build tags; try adding “-tags=” to your gopls “buildFlags” configuration See the documentation for more information on working with build tags: https://github.com/golang/tools/blob/master/gopls/doc/settings.md#buildflags. go list
settings.json 配置中，json第一层添加如下配置即可
"gopls":{"buildFlags":["-tags=debug"]}
