20. Go 語言中關于包匯入必學的 8 個知識點-有解無憂

Hi，大家好，我是明哥，

在自己學習 Golang 的這段時間里，我寫了詳細的學習筆記放在我的個人微信公眾號《Go編程時光》，對于 Go 語言，我也算是個初學者，因此寫的東西應該會比較適合剛接觸的同學，如果你也是剛學習 Go 語言，不防關注一下，一起學習，一起成長，

我的在線博客：http://golang.iswbm.com
我的 Github：github.com/iswbm/GolangCodingTime

1. 單行匯入與多行匯入

在 Go 語言中，一個包可包含多個 .go 檔案（這些檔案必須得在同一級檔案夾中），只要這些 .go 檔案的頭部都使用 package 關鍵字宣告了同一個包，

匯入包主要可分為兩種方式：

單行匯入

import "fmt"
import "sync"

多行匯入

import(
    "fmt"
    "sync"
)

如你所見，Go 語言中匯入的包，必須得用雙引號包含，在這里吐槽一下，

2. 使用別名

在一些場景下，我們可能需要對匯入的包進行重新命名，比如

我們匯入了兩個具有同一包名的包時產生沖突，此時這里為其中一個包定義別名

import (
    "crypto/rand"
    mrand "math/rand" // 將名稱替換為mrand避免沖突
)

我們匯入了一個名字很長的包，為了避免后面都寫這么長串的包名，可以這樣定義別名

import hw "helloworldtestmodule"

防止匯入的包名和本地的變數發生沖突，比如 path 這個很常用的變數名和匯入的標準包沖突，

import pathpkg "path"

3. 使用點操作

如里在我們程式內部里頻繁使用了一個工具包，比如 fmt，那每次使用它的列印函式列印時，都要包名+方法名，

對于這種使用高頻的包，可以在匯入的時，就把它定義會 "自己人"（方法是使用一個 . ），自己人的話，不分彼此，它的方法，就是我們的方法，

從此，我們列印再也不用加 fmt 了，

import . "fmt"

func main() {
	Println("hello, world")
}

但這種用法，會有一定的隱患，就是匯入的包里可能有函式，會和我們自己的函式發生沖突，

4. 包的初始化

每個包都允許有一個 init 函式，當這個包被匯入時，會執行該包的這個 init 函式，做一些初始化任務，

對于 init 函式的執行有兩點需要注意

init 函式優先于 main 函式執行
在一個包參考鏈中，包的初始化是深度優先的，比如，有這樣一個包參考關系：main→A→B→C，那么初始化順序為
```
C.init→B.init→A.init→main
```

5. 包的匿名匯入

當我們匯入一個包時，如果這個包沒有被使用到，在編譯時，是會報錯的，

但是有些情況下，我們匯入一個包，只想執行包里的 init 函式，來運行一些初始化任務，此時怎么辦呢？

可以使用匿名匯入，用法如下，其中下劃線為空白識別符號，并不能被訪問

// 注冊一個PNG decoder
import _ "image/png"

由于匯入時，會執行 init 函式，所以編譯時，仍然會將這個包編譯到可執行檔案中，

6. 匯入的是路徑還是包？

當我們使用 import 匯入 testmodule/foo 時，初學者，經常會問，這個 foo 到底是一個包呢，還是只是包所在目錄名？

import "testmodule/foo"

為了得出這個結論，專門做了個試驗（請看「第七點里的代碼示例」），最后得出的結論是：

匯入時，是按照目錄匯入，匯入目錄后，可以使用這個目錄下的所有包，
出于習慣，包名和目錄名通常會設定成一樣，所以會讓你有一種你匯入的是包的錯覺，

7. 相對匯入和絕對匯入

據我了解在 Go 1.10 之前，好像是不支持相對匯入的，在 Go 1.10 之后才可以，

絕對匯入：從 $GOPATH/src 或 $GOROOT 或者 $GOPATH/pkg/mod 目錄下搜索包并匯入

相對匯入：從當前目錄中搜索包并開始匯入，就像下面這樣

import (
    "./module1"
    "../module2"
    "../../module3"
    "../module4/module5"
)

分別舉個例子吧

一、使用絕對匯入

有如下這樣的目錄結構（注意確保當前目錄在 GOPATH 下）

其中 main.go 是這樣的

package main

import (
	"app/utilset"   // 這種使用的就是絕對路徑匯入
)

func main() {
	utils.PrintHello()
}

而在 main.go 的同級目錄下，還有另外一個檔案夾 utilset ，為了讓你理解「第六點：import 匯入的是路徑而不是包」，我在 utilset 目錄下定義了一個 hello.go 檔案，這個go檔案定義所屬包為 utils，

package utils

import "fmt"

func PrintHello(){
    fmt.Println("Hello, 我在 utilset 目錄下的 utils 包里")
}

運行結果如下

二、使用相對匯入

還是上面的代碼，將絕對匯入改為相對匯入后

將 GOPATH 路徑設定回去（請對比上面使用絕對路徑的 GOPATH）

然后再次運行

總結一下，使用相對匯入，有兩點需要注意

專案不要放在 $GOPATH/src 下，否則會報錯（比如我修改當前專案目錄為GOPATH后，運行就會報錯）
Go Modules 不支持相對匯入，在你開啟 GO111MODULE 后，無法使用相對匯入，

最后，不得不說的是：使用相對匯入的方式，專案可讀性會大打折扣，不利用開發者理清整個參考關系，

所以一般更推薦使用絕對參考的方式，使用絕對參考的話，又要談及優先級了

8. 包匯入路徑優先級

前面一節，介紹了三種不同的包依賴管理方案，不同的管理模式，存放包的路徑可能都不一樣，有的可以將包放在 GOPATH 下，有的可以將包放在 vendor 下，還有些包是內置包放在 GOROOT 下，

那么問題就來了，如果在這三個不同的路徑下，有一個相同包名但是版本不同的包，我們匯入的時候，是選擇哪個進行匯入呢？

這就需要我們搞懂，在 Golang 中包搜索路徑優先級是怎樣的？

這時候就需要區分，是使用哪種模式進行包的管理的，

如果使用 govendor

當我們匯入一個包時，它會：

先從專案根目錄的 vendor 目錄中查找
最后從 $GOROOT/src 目錄下查找
然后從 $GOPATH/src 目錄下查找
都找不到的話，就報錯，

為了驗證這個程序，我在創建中創建一個 vendor 目錄后，就開啟了 vendor 模式了，我在 main.go 中隨便匯入一個包 pkg，由于這個包是我隨便指定的，當然會找不到，找不到就會報錯， Golang 會在報錯資訊中列印中搜索的程序，從這個資訊中，就可以看到 Golang 的包查找優先級了，

如果使用 go modules

你匯入的包如果有域名，都會先在 $GOPATH/pkg/mod 下查找，找不到就連網去該網站上尋找，找不到或者找到的不是一個包，則報錯，

而如果你匯入的包沒有域名（比如 "fmt"這種），就只會到 $GOROOT 里查找，

還有一點很重要，當你的專案下有 vendor 目錄時，不管你的包有沒有域名，都只會在 vendor 目錄中想找，

通常vendor 目錄是通過 go mod vendor 命令生成的，這個命令會將專案依賴全部打包到你的專案目錄下的 verdor 檔案夾中，

20. Go 語言中關于包匯入必學的 8 個知識點