go env · GO 命令教程

# go env 命令```go env```用于打印Go語言的環境信息。其中的一些信息我們在之前已經多次提及，但是卻沒有進行詳細的說明。在本小節，我們會對這些信息進行深入介紹。我們先來看一看```go env```命令情況下都會打印出哪些Go語言通用環境信息。 _表0-25 ```go env```命令可打印出的Go語言通用環境信息_ <table class="table table-bordered table-striped table-condensed"> <tr> <th width=100px> 名稱 </th> <th width=220px> 說明 </th> </tr> <tr> <td> CGO_ENABLED </td> <td> 指明cgo工具是否可用的標識。 </td> </tr> <tr> <td> GOARCH </td> <td> 程序構建環境的目標計算架構。 </td> </tr> <tr> <td> GOBIN </td> <td> 存放可執行文件的目錄的絕對路徑。 </td> </tr> <tr> <td> GOCHAR </td> <td> 程序構建環境的目標計算架構的單字符標識。 </td> </tr> <tr> <td> GOEXE </td> <td> 可執行文件的后綴。 </td> </tr> <tr> <td> GOHOSTARCH </td> <td> 程序運行環境的目標計算架構。 </td> </tr> <tr> <td> GOOS </td> <td> 程序構建環境的目標操作系統。 </td> </tr> <tr> <td> GOHOSTOS </td> <td> 程序運行環境的目標操作系統。 </td> </tr> <tr> <td> GOPATH </td> <td> 工作區目錄的絕對路徑。 </td> </tr> <tr> <td> GORACE </td> <td> 用于數據競爭檢測的相關選項。 </td> </tr> <tr> <td> GOROOT </td> <td> Go語言的安裝目錄的絕對路徑。 </td> </tr> <tr> <td> GOTOOLDIR </td> <td> Go工具目錄的絕對路徑。 </td> </tr> </table> 下面我們對這些環境信息進行逐一說明。 **CGO_ENABLED** 通過上一小節的介紹，相信讀者對cgo工具已經很熟悉了。我們提到過，標準go命令可以自動的使用cgo工具對導入了代碼包C的代碼包和源碼文件進行處理。這里所說的“自動”并不是絕對的。因為當環境變量CGO_ENABLED被設置為0時，標準go命令就不能處理導入了代碼包C的代碼包和源碼文件了。請看下面的示例： hc@ubt:~/golang/goc2p/src/basic/cgo$ export CGO_ENABLED=0 hc@ubt:~/golang/goc2p/src/basic/cgo$ go build -x WORK=/tmp/go-build775234613 我們臨時把環境變量CGO_ENABLED的值設置為0，然后執行```go build```命令并加入了標記```-x```。標記```-x```會讓命令程序將運行期間所有實際執行的命令都打印到標準輸出。但是，在執行命令之后沒有任何命令被打印出來。這說明對代碼包```basic/cgo```的構建操作并沒有被執行。這是因為，構建這個代碼包需要用到cgo工具，但cgo工具已經被禁用了。下面，我們再來運行調用了代碼包```basic/cgo```中函數的命令源碼文件cgo_demo.go。也就是說，命令源碼文件cgo_demo.go間接的導入了代碼包```C```。還記得嗎？這個命令源碼文件被存放在goc2p項目的代碼包```basic/cgo```中。示例如下： hc@ubt:~/golang/goc2p/src/basic/cgo$ export CGO_ENABLED=0 hc@ubt:~/golang/goc2p/src/basic/cgo$ go run -work cgo_demo.go WORK=/tmp/go-build856581210 # command-line-arguments ./cgo_demo.go:4: can't find import: "basic/cgo/lib" 在上面的示例中，我們在執行```go run```命令時加入了兩個標記——```-a```和```-work```。標記```-a```會使命令程序強行重新構建所有的代碼包（包括涉及到的標準庫），即使它們已經是最新的了。標記```-work```會使命令程序將臨時工作目錄的絕對路徑打印到標準輸出。命令程序輸出的錯誤信息顯示，命令程序沒有找到代碼包```basic/cgo```。其原因是由于代碼包```basic/cgo```無法被構建。所以，命令程序在臨時工作目錄和工作區中都找不到代碼包basic/cgo對應的歸檔文件cgo.a。如果我們使用命令```ll /tmp/go-build856581210```查看臨時工作目錄，也找不到名為basic的目錄。不過，如果我們在環境變量CGO_ENABLED的值為1的情況下生成代碼包```basic/cgo```對應的歸檔文件cgo.a，那么無論我們之后怎樣改變環境變量CGO_ENABLED的值也都可以正確的運行命令源碼文件cgo_demo.go。即使我們在執行```go run```命令時加入標記```-a```也是如此。因為命令程序依然可以在工作區中找到之前在我們執行```go install```命令時生成的歸檔文件cgo.a。示例如下： hc@ubt:~/golang/goc2p/src/basic/cgo$ export CGO_ENABLED=1 hc@ubt:~/golang/goc2p/src/basic/cgo$ go install ../basic/cgo hc@ubt:~/golang/goc2p/src/basic/cgo$ export CGO_ENABLED=0 hc@ubt:~/golang/goc2p/src/basic/cgo$ go run -a -work cgo_demo.go WORK=/tmp/go-build130612063 The square root of 2.330000 is 1.526434. ABC CFunction1() is called. GoFunction1() is called. 由此可知，只要我們事先成功安裝了引用了代碼包C的代碼包，即生成了對應的代碼包歸檔文件，即使cgo工具在之后被禁用，也不會影響到其它Go語言代碼對該代碼包的使用。當然，命令程序首先會到臨時工作目錄中尋找需要的代碼包歸檔文件。關于cgo工具還有一點需要特別注意，即：當存在交叉編譯的情況時，cgo工具一定是不可用的。在標準go命令的上下文環境中，交叉編譯意味著程序構建環境的目標計算架構的標識與程序運行環境的目標計算架構的標識不同，或者程序構建環境的目標操作系統的標識與程序運行環境的目標操作系統的標識不同。在這里，我們可以粗略認為交叉編譯就是在當前的計算架構和操作系統下編譯和構建Go語言代碼并生成針對于其他計算架構或/和操作系統的編譯結果文件和可執行文件。 **GOARCH** GOARCH的值的含義是程序構建環境的目標計算架構的標識，也就是程序在構建或安裝時所對應的計算架構的名稱。在默認情況下，它會與程序運行環境的目標計算架構一致。即它的值會與GOHOSTARCH的值是相同。但如果我們顯式的設置了環境變量GOARCH，則它的值就會是這個環境變量的值。 **GOBIN** GOBIN的值為存放可執行文件的目錄的絕對路徑。它的值來自環境變量GOBIN。在我們使用```go tool install```命令安裝命令源碼文件時生成的可執行文件會存放于這個目錄中。 **GOCHAR** GOCHAR的值是程序構建環境的目標計算架構的單字符標識。它的值會根據GOARCH的值來設置。當GOARCH的值為386時，GOCHAR的值就是8。當GOARCH的值為amd64時GOCHAR的值就是6。而GOCHAR的值5與GOARCH的值arm相對應。 GOCHAR主要有兩個用途，列舉如下： 1. Go語言官方的平臺相關的工具的名稱會以它的值為前綴。的名稱會以GOCHAR的值為前綴。比如，在amd64計算架構下，用于編譯Go語言代碼的編譯器的名稱是6g，鏈接器的名稱是6l。用于編譯C語言代碼的編譯器的名稱是6c。而用于編譯匯編語言代碼的編譯器的名稱為6a。 2. Go語言的官方編譯器生成的結果文件會以GOCHAR的值作為擴展名。Go語言的官方編譯器6g在對命令源碼文件編譯之后會把結果文件_go_.6存放到臨時工作目錄的相應位置中。 **GOEXE** GOEXE的值會被作為可執行文件的后綴。它的值與GOOS的值存在一定關系，即只有GOOS的值為“windows”時GOEXE的值才會是“.exe”，否則其值就為空字符串“”。這與在各個操作系統下的可執行文件的默認后綴是一致的。 **GOHOSTARCH** GOHOSTARCH的值的含義是程序運行環境的目標計算架構的標識，也就是程序在運行時所在的計算機系統的計算架構的名稱。在通常情況下，它的值不需要被顯式的設置。因為用來安裝Go語言的二進制分發文件和MSI（Microsoft軟件安裝）軟件包文件都是平臺相關的。所以，對于不同計算架構的Go語言環境來說，它都會是一個常量。 **GOHOSTOS** GOHOSTOS的值的含義是程序運行環境的目標操作系統的標識，也即程序在運行時所在的計算機系統的操作系統的名稱。與GOHOSTARCH類似，它的值在不同的操作系統下是固定不變的，同樣不需要顯式的設置。 **GOPATH** 這個環境信息我們在之前已經提到過很多次。它的值指明了Go語言工作區目錄的絕對路徑。我們需要顯式的設置環境變量GOPATH。如果有多個工作區，那么多個工作區的絕對路徑之間需要用分隔符分隔。在windows操作系統下，這個分隔符為“;”。在其它操作系統下，這個分隔符為“:”。注意，GOPATH的值不能與GOROOT的值相同。 **GORACE** GORACE的值包含了用于數據競爭檢測的相關選項。數據競爭是在并發程序中最常見和最難調試的一類bug。數據競爭會發生在多個Goroutine爭相訪問相同的變量且至少有一個Goroutine中的程序在對這個變量進行寫操作的情況下。數據競爭檢測需要被顯式的開啟。還記得標記```-race```嗎？我們可以通過在執行一些標準go命令時加入這個標記來開啟數據競爭檢測。在這種情況下，GORACE的值就會被使用到了。支持```-race```標記的標準go命令包括：```go test```命令、```go run```命令、```go build```命令和```go install```命令。 GORACE的值形如“option1=val1 option2=val2”，即：選項名稱與選項值之間以等號“=”分隔，多個選項之間以空格“ ”分隔。數據競爭檢測的選項包括log_path、exitcode、strip_path_prefix和history_size。為了設置GORACE的值，我們需要設置環境變量GORACE。或者，我們也可以在執行go命令時臨時設置它，像這樣： hc@ubt:~/golang/goc2p/src/cnet/ctcp$ GORACE="log_path=/home/hc/golang/goc2p /race/report strip_path_prefix=home/hc/golang/goc2p/" go test -race 關于數據競爭檢測的更多細節我們將會在本書的第三部分予以說明。 **GOROOT** GOROOT會是我們在安裝Go語言時第一個碰到Go語言環境變量。它的值指明了Go語言的安裝目錄的絕對路徑。但是，只有在非默認情況下我們才需要顯式的設置環境變量GOROOT。這里所說的默認情況是指：在Windows操作系統下我們把Go語言安裝到c:\Go目錄下，或者在其它操作系統下我們把Go語言安裝到/usr/local/go目錄下。另外，當我們不是通過二進制分發包來安裝Go語言的時候，也不需要設置環境變量GOROOT的值。比如，在Windows操作系統下，我們可以使用MSI軟件包文件來安裝Go語言。 **GOTOOLDIR** GOTOOLDIR的值指明了Go工具目錄的絕對路徑。根據GOROOT、GOHOSTOS和GOHOSTARCH來設置。其值為$GOROOT/pkg/tool/$GOOS_$GOARCH。關于這個目錄，我們在之前也提到過多次。除了上面介紹的這些通用的Go語言環境信息，還兩個針對于非Plan 9操作系統的環境信息。它們是CC和GOGCCFLAGS。環境信息CC的值是操作系統默認的C語言編譯器的命令名稱。環境信息GOGCCFLAGS的值則是Go語言在使用操作系統的默認C語言編譯器對C語言代碼進行編譯時加入的參數。如果我們要有針對性的查看上述的一個或多個環境信息，可以在```go env```命令的后面加入它們的名字并執行之。在```go env```命令和環境信息名稱之間需要用空格分隔，多個環境信息名稱之間也需要用空格分隔。示例如下： hc@ubt:~$ go env GOARCH GOCHAR 386 8 上例的```go env```命令的輸出信息中，每一行對一個環境信息的值，且其順序與我們輸入的環境信息名稱的順序一致。比如，386為環境信息GOARCH，而8則是環境信息GOCHAR的值。 ```go env```命令能夠讓我們對當前的Go語言環境進行簡要的了解。通過它，我們也可以對當前安裝的Go語言的環境設置進行簡單的檢查。