go build
這個命令主要用于編譯代碼。在包的編譯過程中,若有必要,會同時編譯與之相關聯的包。
?如果是普通包,當你執行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文件。
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遞交源碼,在本機測試的時候這些編譯文件都是和系統相關的,但是對于源碼管理來說沒必要。
參數介紹
-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工具會自動根據不同的域名調用不同的源碼工具,對應關系如下:
所以為了go get?能正常工作,你必須確保安裝了合適的源碼管理工具,并同時把這些命令加入你的PATH中。其實go get支持自定義域名的功能
參數介紹:
-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的文件,生成并運行測試用的可執行文件。輸出的信息類似
默認的情況下,不需要任何的參數,它會自動把你源碼包下面所有test文件測試完畢,當然你也可以帶上參數
這里我介紹幾個我們常用的參數:
-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
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 run 編譯并運行Go程序
go list 列出當前全部安裝的package
go env 查看當前go的環境變量
go version 查看go當前的版本