假设我有一个基于哪个操作系统的 go 项目,在某些情况下是哪个发行版,我想使用 Systemd 客户端包、Upstart 客户端包、sysv 客户端包和启动客户端包。是否可以有选择地导入每个包,以便我只导入我正在构建的每个操作系统/发行版所需的包?还是我必须为每个操作系统/发行版导入每个包?
2 回答
构建约束,也称为构建标记,是开始的行注释
// +build
列出了文件应包含在包中的条件。约束可以出现在任何类型的源文件中(不仅仅是 Go),但它们必须出现在文件顶部附近,前面只能有空行和其他行注释。这些规则意味着在 Go 文件中,构建约束必须出现在 package 子句之前。
为了将构建约束与包文档区分开来,一系列构建约束必须后跟一个空行。
构建约束被评估为空格分隔选项的 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
在特定构建期间,满足以下条件:
- the target operating system, as spelled by runtime.GOOS - the target architecture, as spelled by runtime.GOARCH - the compiler being used, either "gc" or "gccgo" - "cgo", if ctxt.CgoEnabled is true - "go1.1", from Go version 1.1 onward - "go1.2", from Go version 1.2 onward - "go1.3", from Go version 1.3 onward - "go1.4", from Go version 1.4 onward - "go1.5", from Go version 1.5 onward - "go1.6", from Go version 1.6 onward - any additional words listed in ctxt.BuildTags
如果文件名在去除扩展名和可能的 _test 后缀后匹配以下任何模式:
*_GOOS *_GOARCH *_GOOS_GOARCH
(例如:source_windows_amd64.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。
除了 android 标签和文件之外,使用 GOOS=android 还匹配 GOOS=linux 的构建标签和文件。
使用构建约束。
使用包含多个文件的单个包。每个文件专门针对特定的操作系统、体系结构等组合。
构建约束被评估为空格分隔选项的 OR;每个选项评估为其逗号分隔项的 AND;并且每个术语都是一个字母数字词,或者,前面有!
实际上,这将随着 Go 1.17(2021 年第三季度)而改变
//go:build
线条该
go
命令现在可以理解//go:build
行并优先使用它们而不是// +build
行。新语法使用布尔表达式,就像 Go 一样,应该更不容易出错。
在此版本中,完全支持新语法,所有 Go 文件都应更新为具有相同含义的两种形式。
为了帮助迁移,gofmt
现在自动同步这两个表单。
有关语法和迁移计划的更多详细信息,请参阅https://golang.org/design/draft-gobuild。
从设计文件:
该设计的核心思想是用使用更熟悉的布尔表达式
// +build
的新行替换当前用于构建标签选择的行。//go:build
例如,旧语法
// +build linux // +build 386
将被新语法取代
//go:build linux && 386