Go語(yǔ)言 官方工具鏈

目前，Go官方工具鏈中提供的工具是使用得最廣泛的Go開(kāi)發(fā)工具。 《Go語(yǔ)言101》所有中所有的實(shí)例代碼都使用Go官方工具鏈中提供的標(biāo)準(zhǔn)編譯器編譯驗(yàn)證過(guò)。

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

安裝Go官方工具鏈

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

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

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

Go官方工具鏈近來(lái)的版本均支持一個(gè)稱為Go模塊（Go modules）的特性，用來(lái)管理項(xiàng)目依賴。 此特性在版本1.11中被試驗(yàn)性地引入并從版本1.16開(kāi)始被默認(rèn)支持。

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

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

最簡(jiǎn)單的Go程序

讓我們寫(xiě)一個(gè)簡(jiǎn)單的Go程序，并且學(xué)習(xí)如何運(yùn)行之。

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

package main

func main() {
}

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

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

運(yùn)行一個(gè)Go程序

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

打開(kāi)一個(gè)終端（控制臺(tái)）并進(jìn)入上述源文件所在的目錄，然后運(yùn)行

$ go run simplest-go-program.go

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

如果代碼中有語(yǔ)法錯(cuò)誤，這些錯(cuò)誤將輸出在終端中。

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

$ go run .

注意：

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

更多go子命令

上面提到的三個(gè)go子命令（go run、go build和go install） 將只會(huì)輸出代碼語(yǔ)法錯(cuò)誤。它們不會(huì)輸出可能的代碼邏輯錯(cuò)誤（即警告）。 go vet子命令可以用來(lái)檢查可能的代碼邏輯錯(cuò)誤（即警告）。

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

我們可以使用go test子命令來(lái)運(yùn)行單元和基準(zhǔn)測(cè)試用例。

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

強(qiáng)烈推薦讓你的Go項(xiàng)目支持Go模塊特性來(lái)簡(jiǎn)化依賴管理。對(duì)一個(gè)支持Go模塊特性的項(xiàng)目：

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

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

我們可以運(yùn)行go help aSubCommand來(lái)查看一個(gè)子命令aSubCommand的幫助信息。

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

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

查看Go代碼庫(kù)文檔

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

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