【Golang】學習筆記3 -- Go 常用命令

Go 命令

Go語言內建有一套完整的命令操作工具，我們可以通過在命令列中執行go來查看它們：

上面這張圖的這些命令對於我們平時編寫的代碼非常有用，接下來就讓我們瞭解一些常用的命令。

go build

這個命令主要用於編譯代碼。在包的編譯過程中，若有必要，會同時編譯與之相關聯的包。

• 如果是普通包，就像我們在1.2節中編寫的mymath包那樣，當你執行go build之後，它不會產生任何檔案。如果你需要在`$GOPATH/pkg下產生相應的檔案，那就得執行go install**。
• 如果是main包，當你執行go build之後，它就會在目前的目錄下產生一個可執行檔。如果你需要在`$GOPATH/bin下產生相應的檔案，需要執行go install，或者使用go build -o 路徑/a.exe**。
• 如果某個專案檔夾下有多個檔案，而你只想編譯某個檔案，就可在go build之後加上檔案名稱，例如go build a.go；go build命令預設會編譯目前的目錄下的所有go檔案。
• 你也可以指定編譯輸出的檔案名稱。例如1.2節中的mathapp應用，我們可以指定go build -o astaxie.exe，預設情況是你的package名(非main包)，或者是第一個源檔案的檔案名稱(main包)。
  （註：實際上，package名在Go語言規範中指代碼中“package”後使用的名稱，此名稱可以與檔案夾名不同。預設產生的可執行檔名是檔案夾名。）
  • go build會忽略目錄下以“_”或“.”開頭的go檔案。

• 如果你的原始碼針對不同的作業系統需要不同的處理，那麼你可以根據不同的作業系統尾碼來命名檔案。例如有一個讀取數組的程式，它對於不同的作業系統可能有如下幾個源檔案：

array_linux.go array_darwin.go array_windows.go array_freebsd.go

go build的時候會選擇性地編譯以系統名結尾的檔案（Linux、Darwin、Windows、Freebsd）。例如Linux系統下面編譯只會選擇array_linux.go檔案，其它系統命名尾碼檔案全部忽略。

參數的介紹

• -o 指定輸出的檔案名稱，可以帶上路徑，例如 go build -o a/b/c
• -i 安裝相應的包，編譯+go install
• -a 更新全部已經是最新的包的，但是對標準包不適用
• -n 把需要執行的編譯命令列印出來，但是不執行，這樣就可以很容易的知道底層是如何啟動並執行
• -p n 指定可以並行可啟動並執行編譯數目，預設是CPU數目
• -race 開啟編譯的時候自動檢測資料競爭的情況，目前只支援64位的機器
• -v 列印出來我們正在編譯的包名
• -work 列印出來編譯時間候的臨時檔案夾名稱，並且如果已經存在的話就不要刪除
• -x 列印出來執行的命令，其實就是和-n的結果類似，只是這個會執行
• -ccflags 'arg list' 傳遞參數給5c, 6c, 8c 調用
• -compiler name 指定相應的編譯器，gccgo還是gc
• -gccgoflags 'arg list'傳遞參數給gccgo編譯串連調用
• -gcflags 'arg list' 傳遞參數給5g, 6g, 8g 調用
• -installsuffix suffix 為了和預設的安裝包區別開來，採用這個首碼來重新安裝那些依賴的包，-race的時候預設已經是-installsuffix race,大家可以通過`-n**命令來驗證
• -ldflags 'flag list' 傳遞參數給5l, 6l, 8l 調用
• -tags 'tag list' 設定在編譯的時候可以適配的那些tag，詳細的tag限制參考裡面的 Build Constraints

go clean

這個命令是用來移除當前源碼包和關聯源碼包裡面編譯產生的檔案。這些檔案包括

_obj/            舊的object目錄，由Makefiles遺留_test/           舊的test目錄，由Makefiles遺留_testmain.go     舊的gotest檔案，由Makefiles遺留test.out         舊的test記錄，由Makefiles遺留build.out        舊的test記錄，由Makefiles遺留*.[568ao]        object檔案，由Makefiles遺留DIR(.exe)        由go build產生DIR.test(.exe)   由go test -c產生MAINFILE(.exe)   由go build MAINFILE.go產生*.so             由 SWIG 產生

我一般都是利用這個命令清除編譯檔案，然後github遞交源碼，在本機測試的時候這些編譯檔案都是和系統相關的，但是對於源碼管理來說沒必要。

$ go clean -i -ncd /Users/astaxie/develop/gopath/src/mathapprm -f mathapp mathapp.exe mathapp.test mathapp.test.exe app app.exerm -f /Users/astaxie/develop/gopath/bin/mathapp

參數介紹

• -i 清除關聯的安裝的包和可運行檔案，也就是通過go install安裝的檔案
• -n 把需要執行的清除命令列印出來，但是不執行，這樣就可以很容易的知道底層是如何啟動並執行
• -r 迴圈的清除在import中引入的包
• -x 列印出來執行的詳細命令，其實就是-n列印的執行版本

go fmt

有過C/C++經驗的讀者會知道,一些人經常為代碼採取K&R風格還是ANSI風格而爭論不休。在go中，代碼則有標準的風格。由於之前已經有的一些習慣或其它的原因我們常將代碼寫成ANSI風格或者其它更合適自己的格式，這將為人們在閱讀別人的代碼時添加不必要的負擔，所以go強制了代碼格式（比如左大括弧必須放在行尾），不按照此格式的代碼將不能編譯通過，為了減少浪費在排版上的時間，go工具集中提供了一個go fmt命令 它可以幫你格式化你寫好的代碼檔案，使你寫代碼的時候不需要關心格式，你只需要在寫完之後執行go fmt <檔案名稱>.go，你的代碼就被修改成了標準格式，但是我平常很少用到這個命令，因為開發工具裡面一般都帶了儲存時候自動格式化功能，這個功能其實在底層就是調用了go fmt。接下來的一節我將講述兩個工具，這兩個工具都內建了儲存檔案時自動化go fmt功能。

使用go fmt命令，其實是調用了gofmt，而且需要參數-w，否則格式化結果不會寫入檔案。gofmt -w -l src，可以格式化整個項目。

所以go fmt是gofmt的上層一個封裝的命令，我們想要更多的個人化的格式化可以參考 gofmt

gofmt的參數介紹

• -l 顯示那些需要格式化的檔案
• -w 把改寫後的內容直接寫入到檔案中，而不是作為結果列印到標準輸出。
• -r 添加形如“a[b:len(a)] -> a[b:]”的重寫規則，方便我們做批量替換
• -s 簡化檔案中的代碼
• -d 顯示格式化前後的diff而不是寫入檔案，預設是false
• -e 列印所有的語法錯誤到標準輸出。如果不使用此標記，則只會列印不同行的前10個錯誤。
• -cpuprofile 支援偵錯模式，寫入相應的cpufile到指定的檔案

go get

這個命令是用來動態擷取遠程程式碼封裝的，目前支援的有BitBucket、GitHub、Google Code和Launchpad。這個命令在內部實際上分成了兩步操作：第一步是下載源碼包，第二步是執行go install。下載源碼包的go工具會自動根據不同的網域名稱調用不同的源碼工具，對應關係如下：

BitBucket (Mercurial Git)GitHub (Git)Google Code Project Hosting (Git, Mercurial, Subversion)Launchpad (Bazaar)

所以為了go get 能正常工作，你必須確保安裝了合適的源碼管理工具，並同時把這些命令加入你的PATH中。其實go get支援自訂網域名的功能，具體參見go help remote。

參數介紹：

• -d 只下載不安裝
• -f 只有在你包含了-u**參數的時候才有效，不讓-u**去驗證import中的每一個都已經擷取了，這對於本地fork的包特別有用
• -fix 在擷取源碼之後先運行fix，然後再去做其他的事情
• -t 同時也下載需要為運行測試所需要的包
• -u 強制使用網路去更新包和它的依賴包
• -v 顯示執行的命令

go install

這個命令在內部實際上分成了兩步操作：第一步是產生結果檔案(可執行檔或者.a包)，第二步會把編譯好的結果移到\(GOPATH/pkg**或者**\)GOPATH/bin。

參數支援go build的編譯參數。大家只要記住一個參數-v就好了，這個隨時隨地的可以查看底層的執行資訊。

go test

執行這個命令，會自動讀取源碼目錄下面名為`*_test.go**的檔案，產生並運行測試用的可執行檔。輸出的資訊類似

ok   archive/tar   0.011sFAIL archive/zip   0.022sok   compress/gzip 0.033s...

預設的情況下，不需要任何的參數，它會自動把你源碼包下面所有test檔案測試完畢，當然你也可以帶上參數，詳情請參考go help testflag

這裡我介紹幾個我們常用的參數：

• -bench regexp 執行相應的benchmarks，例如 -bench=.
• -cover 開啟測試覆蓋率
• -run regexp 只運行regexp匹配的函數，例如 -run=Array 那麼就執行包含有Array開頭的函數
• -v 顯示測試的詳細命令

go tool

go tool下面下載聚集了很多命令，這裡我們只介紹兩個，fix和vet

• go tool fix .用來修複以前老版本的代碼到新版本，例如go1之前老版本的代碼轉化到go1,例如API的變化
• go tool vet directory|files 用來分析目前的目錄的代碼是否都是正確的代碼,例如是不是調用fmt.Printf裡面的參數不正確，例如函數裡面提前return瞭然後出現了無用代碼之類的。

go generate

這個命令是從Go1.4開始才設計的，用於在編譯前自動化產生某類代碼。go generate和go build是完全不一樣的命令，通過分析源碼中特殊的注釋，然後執行相應的命令。這些命令都是很明確的，沒有任何的依賴在裡面。而且大家在用這個之前心裏面一定要有一個理念，這個go generate是給你用的，不是給使用你這個包的人用的，是方便你來產生一些代碼的。

這裡我們來舉一個簡單的例子，例如我們經常會使用yacc來產生代碼，那麼我們常用這樣的命令：

go tool yacc -o gopher.go -p parser gopher.y

-o 指定了輸出的檔案名稱， -p指定了package的名稱，這是一個單獨的命令，如果我們想讓go generate來觸發這個命令，那麼就可以在當然目錄的任意一個xxx.go檔案裡面的任意位置增加一行如下的注釋：

//go:generate go tool yacc -o gopher.go -p parser gopher.y

這裡我們注意了，`//go:generate**是沒有任何空格的，這其實就是一個固定的格式，在掃描源碼檔案的時候就是根據這個來判斷的。

所以我們可以通過如下的命令來產生，編譯，測試。如果gopher.y檔案有修改，那麼就重新執行go generate重建檔案就好。

$ go generate$ go build$ go test

godoc

在Go1.2版本之前還支援go doc命令，但是之後全部移到了godoc這個命令下，需要這樣安裝go get golang.org/x/tools/cmd/godoc

很多人說go不需要任何的第三方文檔，例如chm手冊之類的（其實我已經做了一個了，chm手冊），因為它內部就有一個很強大的文檔工具。

如何查看相應package的文檔呢？
例如builtin包，那麼執行godoc builtin
如果是http包，那麼執行godoc net/http
查看某一個包裡面的函數，那麼執行godoc fmt Printf
也可以查看相應的代碼，執行godoc -src fmt Printf

通過命令在命令列執行 godoc -http=:連接埠號碼 比如godoc -http=:8080。然後在瀏覽器中開啟127.0.0.1:8080，你將會看到一個golang.org的本地copy版本，通過它你可以查詢pkg文檔等其它內容。如果你設定了GOPATH，在pkg分類下，不但會列出標準包的文檔，還會列出你本地GOPATH中所有項目的相關文檔，這對於經常被牆的使用者來說是一個不錯的選擇。

其它命令

go還提供了其它很多的工具，例如下面的這些工具

go version 查看go當前的版本go env 查看當前go的環境變數go list 列出當前全部安裝的packagego run 編譯並運行Go程式

以上這些工具還有很多參數沒有一一介紹，使用者可以使用go help 命令擷取更詳細的協助資訊。