21. Go 語言中如何開源自己寫的包給別人用?

Hi浓恳，大家好煮嫌，我是明哥笛谦。

在自己學(xué)習(xí) Golang 的這段時間里，我寫了詳細(xì)的學(xué)習(xí)筆記放在我的個人微信公眾號《Go編程時光》昌阿，對于 Go 語言饥脑，我也算是個初學(xué)者，因此寫的東西應(yīng)該會比較適合剛接觸的同學(xué)宝泵，如果你也是剛學(xué)習(xí) Go 語言好啰，不防關(guān)注一下，一起學(xué)習(xí)儿奶，一起成長框往。

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

通常之前的學(xué)習(xí)，我們知道了在 Go 的項目中闯捎，可以 import 一個托管在遠(yuǎn)程倉庫的模塊椰弊，這個模塊在我們使用 go get 的時候，會下載到本地瓤鼻。

既然是放在遠(yuǎn)程倉庫上秉版，意味著所有人都可以發(fā)布，并且所以人也都可以使用茬祷。

今天就來學(xué)習(xí)一下清焕，如何發(fā)布一個開源的模塊，并且使用它。

1. 新建倉庫

先在你的 Github 上新建一個倉庫秸妥，記得選 Public（默認(rèn)）

然后你會得到一個倉庫地址滚停，在你的電腦上使用 git clone 命令克隆下來

2. 編寫模塊代碼

使用前面學(xué)過的 go mod init 命令進(jìn)行初始化，注意這里的模塊名粥惧，填寫我們的git倉庫地址（但是要去掉.git哈）

$ git clone https://github.com/BingmingWong/goutils.git
$ go mod init github.com/BingmingWong/goutils

然后新建一個 hash 文件夾键畴，存放編寫的一個計算 md5 值工具包，編輯 md5.go

package hash

import (
    "crypto/md5"
    "encoding/hex"
    "errors"
    "fmt"
    "io"
    "os"
)

// get file md5
func FileMd5(filename string) (string, error) {
    file, err := os.Open(filename)
    if err != nil {
    return "", errors.New(
        fmt.Sprintf("md5.go hash.FileMd5 os open error %v", err))
    }
    h := md5.New()
    _, err = io.Copy(h, file)
    if err != nil {
        return "", errors.New(fmt.Sprintf("md5.go hash.FileMd5 io copy error %v", err))
    }

    return hex.EncodeToString(h.Sum(nil)), nil
}

// get string md5
func StringMd5(s string) string {
    md5 := md5.New()
    md5.Write([]byte(s))
    return hex.EncodeToString(md5.Sum(nil))
}

由于我們使用的都是內(nèi)置包突雪，沒有引入第三方的包起惕，所以接下來可以把你剛剛那些新增的文件，全部 push 到 git 倉庫咏删。

$ git add -A
$ git commit -m "Add a md5 function"
$ git push

3. 發(fā)布版本

一切完成后惹想，刷新我們的倉庫，就可以看到我們的剛剛上傳的項目代碼了饵婆，點擊 release 發(fā)布一個版本

然后像下圖一樣勺馆，添加一些版本說明

最后點擊一個 Publish release，就發(fā)布了一個版本

4. 如何使用侨核？

使用 go get 命令下載我們的發(fā)布的模塊

$ go get github.com/BingmingWong/goutils

再使用 tree 命令草穆，查看一下我們下載的包已經(jīng)放入了 $GOPATH/pkg/mod 下。

有一點很有趣的是搓译，我的 Github 用戶名（BingmingWong）是有大寫字母的悲柱，下載下來后，在目錄中大寫字母會對應(yīng)變成 !小寫字母些己，如下所示

這個用戶名看起來有點非主流豌鸡，你要想改的話，也是可以的段标。如果你有其他的開源項目涯冠，github 并不會為你做重定向，你需要自己評估這個風(fēng)險逼庞。

回過頭來蛇更，我還是繼續(xù)講如何使用吧。

下載下來后赛糟，我們試著去調(diào)用一下他的函數(shù)派任，有一點需要注意的是，在這個示例里璧南，你不能使用 github.com/BingmingWong/goutils 去導(dǎo)入掌逛，因為在這個目錄下并沒有 package，所以你必須導(dǎo)入 github.com/BingmingWong/goutils/hash 司倚。

整個過程如下所示豆混，供你參考：