引用构建约束文档:
构建约束是以指令 +build 开头的行注释,列出了文件应包含在包中的条件。约束可能出现在任何类型的源文件中(不仅仅是 Go),但它们必须出现在文件顶部附近,前面只能有空行和其他行注释。
为了将构建约束与包文档区分开来,一系列构建约束必须后跟一个空行。
构建约束被评估为空格分隔选项的 OR;每个选项评估为其逗号分隔项的 AND;并且每个术语都是一个字母数字词,或者,前面有!,它的否定。也就是说,构建约束:
// +build linux,386 darwin,!cgo
对应于布尔公式:
(linux AND 386) OR (darwin AND (NOT cgo))
一个文件可能有多个构建约束。整体约束是各个约束的与。也就是说,构建约束:
// +build linux darwin
// +build 386
对应于布尔公式:
(linux OR darwin) AND 386
在特定构建期间,满足以下条件:
- 目标操作系统,由 runtime.GOOS 拼写
- 目标架构,由 runtime.GOARCH 拼写
- 正在使用的编译器,“gc”或“gccgo”
- “cgo”,如果 ctxt.CgoEnabled 为真
- “go1.1”,从 Go 版本 1.1 开始
- ctxt.BuildTags 中列出的任何其他单词
如果文件名在去除扩展名和可能的 _test 后缀后匹配以下任何模式:
*_GOOS
*_GOARCH
*_GOOS_GOARCH
(例如:source_windows_amd64.go)或文字:
GOOS
GOARCH
(例如:windows.go)其中 GOOS 和 GOARCH 分别代表任何已知的操作系统和体系结构值,则认为该文件具有需要这些术语的隐式构建约束。
要使文件不被考虑用于构建:
// +build ignore
(任何其他不满意的词也可以,但“忽略”是传统的。)
仅在使用 cgo 且仅在 Linux 和 OS X 上构建文件:
// +build linux,cgo darwin,cgo
这样的文件通常与为其他系统实现默认功能的另一个文件配对,在这种情况下,它将带有约束:
// +build !linux,!darwin !cgo
命名文件 dns_windows.go 将导致它仅在为 Windows 构建包时被包含;同样,只有在为 32 位 x86 构建包时才会包含 math_386.s。