構建選項

以下是 go build 命令最常用的一些選項：

• -o: 指定輸出文件名。默認輸出文件名是主軟件包的名稱，在 Windows 系統中會自動添加 .exe 后綴。
• -v: 詳細輸出。該選項會在編譯時打印軟件包的名稱。
• -work: 打印臨時工作目錄，退出時不刪除。該選項對調試很有用。
• -x: 打印指令。該選項可打印 go build 正在執行的指令。
• -asmflags: 傳遞給 go tool asm 調用的參數。
• -buildmode: 要使用的編譯模式。默認構建模式為 exe。其他可能的值包括shared、pie和plugin。
• -buildvcs: 是否在二進制文件中加入版本控制信息。默認值為auto(自動)。

有關 go build 命令的更多信息，可以運行以下命令：

go help build

包含哪些文件

在 Go 中使用 go build 命令時，會編譯當前目錄及其子目錄中的 Go 源文件，以創建可執行的二進制文件。默認情況下只編譯 .go 文件，而忽略目錄中的其他文件類型。不過，值得注意的是，go build 命令的行為可能會受到構建標簽和構建約束的影響。

go build 通常會忽略以下類型的文件：

(1) 擴展名不是 .go 的文件：

目錄中任何沒有 .go 擴展名的文件都將被忽略，包括文本文件、配置文件、圖片等。

(2) 子目錄中的文件：

go build 命令編譯當前目錄及其子目錄中所有 .go 文件，其他文件和目錄通常會被忽略。

(3) 以下劃線或點號開頭的文件：

go 工具會忽略以 . 或 _ 開頭的目錄和文件名，以及名為 testdata 的目錄。

(4) 被構建約束排除的文件：

Go 支持構建約束，允許根據目標操作系統或體系架構等條件，構建過程中包含或排除特定文件。例如，在為非 Windows 平臺構建時，帶有 //go:build windows 等構建約束的文件將被忽略。

(5) 通過構建標簽排除的文件：

構建標簽是 Go 源文件中的特殊注釋，可用于根據自定義條件指定哪些文件應包含在編譯中。如果文件的構建標記與構建上下文不匹配，則會被忽略。

(6) "testdata"目錄中的文件：

testdata 的目錄中的文件將被忽略。該目錄通常用于包含與測試相關的數據，而這些數據并不需要編譯。

構建標簽

Go 的構建標簽提供了一種強大的機制，可在構建過程中包含或排除特定代碼。通過使用構建標簽，開發人員可以定制自己的應用程序，使其適用于不同的構建配置、環境或特定平臺要求。這一功能在處理交叉編譯或為特定操作系統創建二進制文件時尤為重要。

構建標簽是放在 Go 源文件開頭的注釋，指定了一組條件，標識在這些條件下，該文件中的代碼應被包含或排除在聯編過程之外。語法是 //go:build 。例如，考慮這樣一種情況：只有在為應用程序的某個版本構建時，才會包含一段特定的代碼：

main.go

package mainimport "fmt"

var version string
func main() {
    fmt.Println(version)
}

pro.go

//go:build pro
package main
func init() {
    version = "pro"
}

free.go

//go:build free
package main
func init() {
    version = "free"
}

當使用 -tags=free 時，輸出將是 free，因為 free.go 文件已包含在內。而使用 -tags=pro 時，輸出將是 pro。

構建標簽語法

可以像使用編程中的其他條件語句一樣組合約束條件，如 AND、OR、NOT。

NOT：

//go:build !cgo

只有在未啟用 CGO 的情況下，才會在構建過程中包含該文件。

AND：

//go:build cgo && darwin

只有啟用 CGO 并且 GOOS 設置為 darwin 的情況下，才會在構建過程中包含該文件。

OR：

//go:build darwin || linux

組合使用：

//go:build (linux || 386) && (darwin || !cgo)

注意：1.16 及更早版本的 Go 使用了不同的構建約束語法，前綴為 // +build。當遇到舊語法時，gofmt 命令將添加等效的 //go:build 約束。

構建約束

除了使用構建參數設置自定義構建標簽，golang 也會根據環境變量和其他因素自動設置一些標簽。以下是可用標記的列表：

(1) GOOS 和 GOARCH 環境變量

可以在源代碼中設置限制條件，只有在使用了特定 GOOS 或 GOARCH 時才能運行文件，例如：

//go:build darwin,amd64
package utils

(2) GO 版本限制

可以根據構建整個模塊時使用的 go 版本來約束是否包含文件。例如，要只在使用 go 版本為 1.12 及以上時構建文件，可以使用 //go:build go1.18。如果 go 的版本是 1.18 或 1.21（截至本文撰寫時的最新版本），則會包含該文件。