1.簡介

go build 是 Go 語言工具鏈中的一個命令，它用于編譯 Go 源代碼并生成可執行文件。

2.格式

go build [-o output] [build flags] [packages]

• 可選的 -o 選項強制 build 將生成的可執行文件或對象寫入指定的輸出文件或目錄。如果不指定，默認會生成當前目錄下的可執行文件，文件名與包名相同。
• build flags: 可選的構建標志，用于指定構建的行為。
• packages: 要編譯的包或目錄。如果不提供，go build 將編譯當前目錄下的包。

3.選項

-a強制重新編譯所有包，即使它們已經是最新的。這在修改了依賴項后很有用。
-buildmode <mode>用于指定構建的模式。根據所選的模式，Go 可以生成不同類型的輸出，適用于不同的使用場景。比如 default 默認模式，生成一個可執行文件，shared 生成共享庫，archive 生成靜態庫等。詳見 go help buildmode。
-C <dir>運行命令之前，切換到指定目錄。命令行上命名的任何文件都會在更改目錄后進行解釋。如果使用此標志，則必須是命令行中的第一個標志。
-o <file>指定生成的可執行文件的名稱。如果不指定，默認會生成與包名相同的可執行文件。
-v顯示詳細的構建過程，包括每個包的編譯信息。
-race啟用數據競爭檢測。這將使編譯器添加用于檢測并發數據競爭的代碼。
-x顯示構建過程中執行的命令，包括編譯器和鏈接器的調用。
-tags <tag,list>指定構建時使用的構建標簽，逗號分隔。標簽可以控制編譯的條件，例如啟用或禁用某些代碼塊。
-gcflags '[pattern=]arg list'用于設置傳遞給 Go 編譯器的標志，這些標志會影響編譯過程中的垃圾收集器的行為。這個選項可以用于調試和優化編譯過程。常用標志:-m: 提示編譯器提供內存逃逸分析的信息。-m <expr>: 只顯示與特定表達式相關的內存逃逸信息。-l: 禁用內聯優化。-N: 禁用優化。
-ldflags <flags>設置鏈接器標志，用于控制鏈接過程。
-installsuffix <suffix>為當前構建指定一個安裝后綴，這通常用于創建不同版本的二進制文件。
-trimpath移除構建路徑中的文件系統路徑信息，從而在構建過程中避免泄露本地路徑信息。

4.示例

（1）編譯當前目錄的代碼。

go build

（2）編譯并指定輸出文件名。

go build -o myprogram

（3）編譯并顯示詳細信息。

go build -v

（4）禁止內聯優化。

go build -gcflags="-l" mypackage

（5）顯示構建過程中執行的命令，包括編譯器和鏈接器的調用。

go build -x

5.小結

go build 命令提供了豐富的選項，使得編譯 Go 程序更加靈活和高效。通過合理使用這些選項，可以滿足不同的構建需求，如輸出文件命名、啟用調試、交叉編譯等。

在開發過程中，靈活運用這些選項將有助于提高開發效率和代碼質量。

---

參考文獻

go command - cmd/go