# go test
`go test`命令用于對Go語言編寫的程序進行測試。這種測試是以代碼包為單位的。當然，這還需要測試源碼文件的幫助。關于怎樣編寫并寫好Go程序測試代碼，我們會在本章的第二節加以詳述。在這里，我們只討論怎樣使用命令啟動測試。
`go test`命令會自動測試每一個指定的代碼包。當然，前提是指定的代碼包中存在測試源碼文件。關于測試源碼文件方面的知識，在我的圖書《Go并發編程實戰》中有詳細介紹。測試源碼文件是名稱以“_test.go”為后綴的、內含若干測試函數的源碼文件。測試函數一般是以“Test”為名稱前綴并有一個類型為“testing.T”的參數聲明的函數.
現在，我們來測試goc2p項目中的幾個代碼包。在使用```go test```命令時指定代碼包的方式與其他命令無異——使用代碼包導入路徑。如果需要測試多個代碼包，則需要在它們的導入路徑之間加入空格以示分隔。示例如下：
```bash
hc@ubt:~$ go test basic cnet/ctcp pkgtool
ok basic 0.012s
ok cnet/ctcp 2.014s
ok pkgtool 0.014s
```
`go test`命令在執行完所有的代碼包中的測試文件之后，會以代碼包為單位打印出測試概要信息。在上面的示例中，對應三個代碼包的三行信息的第一列都是“ok”。這說明它們都通過了測試。每行的第三列顯示運行相應測試所用的時間，以秒為單位。我們還可以在代碼包目錄下運行不加任何參數的運行`go test`命令。其作用和結果與上面的示例是一樣的。
另外，我們還可以指定測試源碼文件來進行測試。這樣的話，`go test`命令只會執行指定文件中的測試，像這樣：
```bash
hc@ubt:~/golang/goc2p/src/pkgtool$ go test envir_test.go
# command-line-arguments
./envir_test.go:25: undefined: GetGoroot
./envir_test.go:40: undefined: GetAllGopath
./envir_test.go:81: undefined: GetSrcDirs
./envir_test.go:83: undefined: GetAllGopath
./envir_test.go:90: undefined: GetGoroot
FAIL command-line-arguments [build failed]
```
我們看到，與指定源碼文件進行編譯或運行一樣，命令程序會為指定的源碼文件生成一個虛擬代碼包——“command-line-arguments”。但是，測試并沒有通過。但其原因并不是測試失敗，而是編譯失敗。對于運行這次測試的命令程序來說，測試源碼文件envir_test.go是屬于代碼包“command-line-arguments”的。并且，這個測試源碼文件中使用了庫源碼文件envir.go中的函數。但是，它卻沒有顯示導入這個庫源碼文件所屬的代碼包。這顯然會引起編譯錯誤。如果想解決這個問題，我們還需要在執行命令時加入這個測試源碼文件所測試的那個源碼文件。示例如下：
```bash
hc@ubt:~/golang/goc2p/src/pkgtool$ go test envir_test.go envir.go
ok command-line-arguments 0.010s
```
現在，我們故意使代碼包`pkgtool`中的某個測試失敗。現在我們再來運行測試：
```bash
hc@ubt:~$ go test basic cnet/ctcp pkgtool
ok basic 0.010s
ok cnet/ctcp 2.015s
--- FAIL: TestGetSrcDirs (0.00 seconds)
envir_test.go:85: Error: The src dir '/usr/local/go/src/pkg' is incorrect.
FAIL
FAIL pkgtool 0.009s
```
我們通過以上示例中的概要信息獲知，測試源碼文件中envir_test.go的測試函數`TestGetSrcDirs`中的測試失敗了。在包含測試失敗的測試源碼文件名的那一行信息中，緊跟測試源碼文件名的用冒號分隔的數字是錯誤信息所處的行號，在行號后面用冒號分隔的是錯誤信息。這個錯誤信息的內容是用戶自行編寫的。另外，概要信息的最后一行以“FAIL”為前綴。這表明針對代碼包pkgtool的測試未通過。未通過的原因在前面的信息中已有描述。
一般情況下，我們會把測試源碼文件與被測試的源碼文件放在同一個代碼包中。并且，這些源碼文件中聲明的包名也都是相同的。除此之外我們還有一種選擇，那就是測試源碼文件中聲明的包名可以是所屬包名再加“_test”后綴。我們把這種測試源碼文件叫做包外測試源碼文件。不過，包外測試源碼文件存在一個弊端，那就是在它們的測試函數中無法測試被測源碼文件中的包級私有的程序實體，比如包級私有的變量、函數和結構體類型。這是因為這兩者的所屬代碼包是不相同的。所以，我們一般很少會編寫包外測試源碼文件。
**關于標記**
`go test`命令的標記處理部分是龐大且繁雜的，以至于使Go語言的開發者們不得不把這一部分的邏輯從`go test`命令程序主體中分離出來并建立單獨的源碼文件。因為`go test`命令中包含了編譯動作，所以它可以接受可用于`go build`命令的所有標記。另外，它還有很多特有的標記。這些標記的用于控制命令本身的動作，有的用于控制和設置測試的過程和環境，還有的用于生成更詳細的測試結果和統計信息。
可用于`go test`命令的幾個比較常用的標記是`-c`、`-i`和`-o`。這兩個就是用于控制`go test`命令本身的動作的標記。詳見下表。
表0-6 ```go test```命令的標記說明
標記名稱 | 標記描述
------------ | -------------
-c | 生成用于運行測試的可執行文件，但不執行它。這個可執行文件會被命名為“pkg.test”，其中的“pkg”即為被測試代碼包的導入路徑的最后一個元素的名稱。
-i | 安裝/重新安裝運行測試所需的依賴包，但不編譯和運行測試代碼。
-o | 指定用于運行測試的可執行文件的名稱。追加該標記不會影響測試代碼的運行，除非同時追加了標記`-c`或`-i`。
上述這幾個標記可以搭配使用。搭配使用的目的可以是讓`go test`命令既安裝依賴包又編譯測試代碼，但不運行測試。也就是說，讓命令程序跑一遍運行測試之前的所有流程。這可以測試一下測試過程。注意，在加入`-c`標記后，命令程序會把用于運行測試的可執行文件存放到當前目錄下。
除此之外，`go test`命令還有很多功效各異的標記。但是由于這些標記的復雜性，我們需要結合測試源碼文件進行詳細的講解。所以我們在這里略過不講。如果讀者想了解相關詳情，請參看《Go并發編程實戰》的第5章。
