10.3. 包聲明

在每個Go語言源文件的開頭都必須有包聲明語句。包聲明語句的主要目的是確定當前包被其它包導入時默認的標識符(也稱為包名)。

例如,math/rand包的每個源文件的開頭都包含package rand包聲明語句,所以當你導入這個包,你就可以用rand.Int、rand.Float64類似的方式訪問包的成員。

package main

import (
    "fmt"
    "math/rand"
)

func main() {
    fmt.Println(rand.Int())
}

通常來說,默認的包名就是包導入路徑名的最後一段,因此即使兩個包的導入路徑不同,它們依然可能有一個相同的包名。例如,math/rand包和crypto/rand包的包名都是rand。稍後我們將看到如何同時導入兩個有相同包名的包。

關於默認包名一般採用導入路徑名的最後一段的約定也有三種例外情況。第一個例外,包對應一個可執行程序,也就是main包,這時候main包本身的導入路徑是無關緊要的。名字為main的包是給go build(§10.7.3)構建命令一個信息,這個包編譯完之後必須調用連接器生成一個可執行程序。

第二個例外,包所在的目錄中可能有一些文件名是以_test.go為後綴的Go源文件(譯註:前面必須有其它的字符,因為以_.開頭的源文件會被構建工具忽略),並且這些源文件聲明的包名也是以_test為後綴名的。這種目錄可以包含兩種包:一種是普通包,另一種則是測試的外部擴展包。所有以_test為後綴包名的測試外部擴展包都由go test命令獨立編譯,普通包和測試的外部擴展包是相互獨立的。測試的外部擴展包一般用來避免測試代碼中的循環導入依賴,具體細節我們將在11.2.4節中介紹。

第三個例外,一些依賴版本號的管理工具會在導入路徑後追加版本號信息,例如“gopkg.in/yaml.v2”。這種情況下包的名字並不包含版本號後綴,而是yaml。