go 常用命令扼要說明

go 常用命令扼要說明

go build

go build 命令主要是用於測試編譯。在包的編譯過程中，若有必要，會同時編譯與之相關聯的包。

1. 如果是普通包，當你執行go build命令後，不會產生任何文件。

2. 如果是main包，當只執行go build命令後，會在當前目錄下生成一個可執行文件。如果需要在$GOPATH/bin木下生成相應的exe文件，需要執行go install 或者使用 go build -o 路徑/a.exe。

3. 如果某個文件夾下有多個文件，而你只想編譯其中某一個文件，可以在 go build 之後加上文件名，例如 go build a.go；go build 命令默認會編譯當前目錄下的所有go文件。

4. 你也可以指定編譯輸出的文件名。比如，我們可以指定go build -o myapp.exe，默認情況是你的package名(非main包)，或者是第一個源文件的文件名(main包)。

5. go build 會忽略目錄下以”_”或者”.”開頭的go文件。

6. 如果你的源代碼針對不同的操作系統需要不同的處理，那麼你可以根據不同的操作系統後綴來命名文件。例如有一個讀取數組的程序，它對於不同的操作系統可能有如下幾個源文件：

array_linux.go array_darwin.go array_windows.go array_freebsd.go
1
2
3
4
1
2
3
4

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

go clean

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產生

go fmt

go fmt 命令主要是用來幫你格式化所寫好的代碼文件。

比如我們寫了一個格式很糟糕的 test.go 文件，我們只需要使用 fmt go test.go 命令，就可以讓go幫我們格式化我們的代碼文件。但是我們一般很少使用這個命令，因為我們的開發工具一般都帶有保存時自動格式化功能，這個功能底層其實就是調用了 go fmt 命令而已。

使用go fmt命令，更多時候是用gofmt，而且需要參數-w，否則格式化結果不會寫入文件。gofmt -w src，可以格式化整個項目。

go get

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

BitBucket (Mercurial Git)GitHub (Git)Google Code Project Hosting (Git, Mercurial, Subversion)Launchpad (Bazaar)
1
2
3
4
1
2
3
4

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

go get 命令本質上可以理解為：首先通過源碼工具clone代碼到src目錄，然後執行go install。

go install

go install 命令在內部實際上分成了兩步操作：第一步是生成結果文件(可執行文件或者.a包)，第二步會把編譯好的結果移到$GOPATH/pkg 或者$GOPATH/bin。

.exe文件： 一般是 go install 帶main函數的go文件產生的，有函數入口，所有可以直接運行。

.a應用包： 一般是 go install 不包含main函數的go文件產生的，沒有函數入口，只能被調用。

go test

go test 命令，會自動讀取源碼目錄下面名為*_test.go的文件，生成並運行測試用的可執行文件。輸出的信息類似

ok   archive/tar 0.011sFAIL archive/zip 0.022sok   compress/gzip 0.033s ...
1
2
3
4
1
2
3
4

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

go doc

go doc 命令其實就是一個很強大的文檔工具。

如何查看相應package的文檔呢？ 例如builtin包，那麼執行go doc builtin；如果是http包，那麼執行go doc 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 fix 用來修復以前老版本的代碼到新版本，例如go1之前老版本的代碼轉化到go1 go version 查看go當前的版本 go env 查看當前go的環境變量 go list 列出當前全部安裝的package go run 編譯並運行Go程序