Go語言 官方工具鏈

目前，Go官方工具鏈中提供的工具是使用得最廣泛的Go開發(fā)工具。 《Go語言101》所有中所有的實例代碼都使用Go官方工具鏈中提供的標準編譯器編譯驗證過。

本文將介紹如何配置Go開發(fā)環(huán)境和如何使用Go官方工具鏈中提供的go命令。 一些非官方工具鏈中的工具也將簡單提及。

安裝Go官方工具鏈

請從國際官網(wǎng)或者國內(nèi)官網(wǎng)下載Go官方工具鏈， 并按照下載頁面中的說明安裝Go官方工具鏈。

Go官方工具鏈的版本和其所支持的最高Go語言版本是一致的。 比如，Go官方工具鏈1.19.x版本支持從1.0到1.19的所有Go語言版本。

為了從任意目錄運行Go官方工具鏈中工具命令（通過go命令）， Go官方工具鏈安裝目錄下的bin子目錄路徑必須配置在PATH環(huán)境變量中。 當(dāng)使用安裝程序安裝Go官方工具鏈時，安裝程序很可能已經(jīng)自動地將此配置好了。

Go官方工具鏈近來的版本均支持一個稱為Go模塊（Go modules）的特性，用來管理項目依賴。 此特性在版本1.11中被試驗性地引入并從版本1.16開始被默認支持。

我們應(yīng)該了解一個環(huán)境變量：GOPATH。 此環(huán)境變量的默認值為當(dāng)前用戶的HOME目錄下的名為go文件夾對應(yīng)的目錄路徑。 GOPATH環(huán)境變量可以被手動地配置多個路徑。 以后，當(dāng)GOPATH文件夾被提及的時候，它表示GOPATH環(huán)境變量中的第一個路徑對應(yīng)的文件夾。

• GOPATH文件夾中的pkg子文件夾用來緩存被本地項目所依賴的Go模塊（一個Go模塊為若干Go庫包的集合）的版本。
• GOBIN環(huán)境變量用來指定go install子命令產(chǎn)生的Go應(yīng)用程序二進制可執(zhí)行文件應(yīng)該存儲在何處。 它的默認值為GOPATH文件夾中的bin子目錄所對應(yīng)的目錄路徑。 GOBIN路徑需配置在PATH環(huán)境變量中，以便從任意目錄運行這些Go應(yīng)用程序。

最簡單的Go程序

讓我們寫一個簡單的Go程序，并且學(xué)習(xí)如何運行之。

下面的程序應(yīng)該是最簡單的Go程序。

package main

func main() {
}

在此程序中，單詞package和func是兩個關(guān)鍵字。 兩個main是兩個標識符。 標識符和關(guān)鍵字將在后續(xù)的一篇文章中講解。

此程序的第一行指定了當(dāng)前源代碼文件所處的包的包名（此處為main）。 第二行是一個空行，用來增強可讀性。 第三和第四行聲明了一個名為main的函數(shù)。 此函數(shù)為程序的入口函數(shù)。

運行一個Go程序

Go官方工具鏈工具要求所有的Go源代碼文件必須以.go后綴結(jié)尾。 這里，我們假設(shè)上面展示的最簡單的Go程序存放在一個名叫simplest-go-program.go的文件中。

打開一個終端（控制臺）并進入上述源文件所在的目錄，然后運行

$ go run simplest-go-program.go

什么也沒輸出？是的，此程序不做什么有實質(zhì)意義的事兒。

如果代碼中有語法錯誤，這些錯誤將輸出在終端中。

如果一個程序的main包中有若干Go源代碼文件，我們也可以使用下面的命令運行此程序。

$ go run .

注意：

• go run子命令并不推薦在正式的大項目中使用。go run子命令只是一種方便的方式來運行簡單的Go程序。 對于正式的項目，最好使用go build或者go install子命令構(gòu)建可執(zhí)行程序文件來運行Go程序。
• 支持Go模塊特性的Go項目的根目錄下需要一個go.mod文件。此文件可以使用go mod init子命令來生成（見下）。
• 名稱以_和.開頭的源代碼文件將被Go官方工具鏈工具忽略掉。

更多go子命令

上面提到的三個go子命令（go run、go build和go install） 將只會輸出代碼語法錯誤。它們不會輸出可能的代碼邏輯錯誤（即警告）。 go vet子命令可以用來檢查可能的代碼邏輯錯誤（即警告）。

我們可以（并且應(yīng)該常常）使用go fmt子命令來用同一種代碼風(fēng)格格式化Go代碼。

我們可以使用go test子命令來運行單元和基準測試用例。

我們可以使用go doc子命令來（在終端中）查看Go代碼庫包的文檔。

強烈推薦讓你的Go項目支持Go模塊特性來簡化依賴管理。對一個支持Go模塊特性的項目：

• go mod init example.com/myproject命令可以用來在當(dāng)前目錄中生成一個go.mod文件。 當(dāng)前目錄將被視為一個名為example.com/myproject的模塊（即當(dāng)前項目）的根目錄。 此go.mod文件將被用來記錄當(dāng)前項目需要的依賴模塊和版本信息。 我們可以手動編輯或者使用go子命令來修改此文件。
• go mod tidy命令用來通過掃描當(dāng)前項目中的所有代碼來添加未被記錄的依賴至go.mod文件或從go.mod文件中刪除不再被使用的依賴。
• go get命令用拉添加、升級、降級或者刪除單個依賴。此命令不如go mod tidy命令常用。

從Go官方工具鏈1.16版本開始，我們可以運行go install example.com/program@latest來安裝一個第三方Go程序的最新版本（至GOBIN目錄）。 在Go官方工具鏈1.16版本之前，對應(yīng)的命令是go get -u example.com/program（現(xiàn)在已經(jīng)被廢棄而不再推薦被使用了）。

我們可以運行go help aSubCommand來查看一個子命令aSubCommand的幫助信息。

運行不帶參數(shù)的go命令將會列出所有支持的go子命令。

《Go語言101》系列文章將不再對各種go子命令做更多的解釋。 請閱讀官方文檔 （墻外版）以獲取更多信息。

查看Go代碼庫文檔

我們可以使用Go項目文檔和代碼閱讀工具Golds（go101.org/golds，由本書作者老貘開發(fā)）來閱讀代碼庫文檔。 此工具將列出類型的實現(xiàn)關(guān)系，并且支持良好的代碼閱讀體驗。 安裝Golds完成之后，我們可以運行golds std ./...來閱讀Go標準庫和當(dāng)前文件夾下的所有庫包的文檔。

我們可以在國內(nèi)官網(wǎng)或者國際官網(wǎng)閱讀Go官方文檔。