Go中的包

Go中的包的介绍和定义

包（package）是多个Go源码的集合，是一种高级的代码复用方案，Go语言为我们提供了很多内置包，如fmt、strconv、strings、sort、errors、time、encoding/json、os、io等。
Golang中的包可以分为三种：1、系统内置包 2、自定义包 3、第三方包

  • 系统内置包：Golang 语言给我们提供的内置包，引入后可以直接使用，如fmt、strconv、strings、sort、errors、time、encoding/json、os、io等。
  • 自定义包：开发者自己写的包

  • 第三方包：属于自定义包的一种，需要下载安装到本地后才可以使用，如前面给大家介绍的 “github.com/shopspring/decimal”包解决float精度丢失问题。

    Go包管理工具 go mod

    在Golang1.11版本之前如果我们要自定义包的话必须把项目放在GOPATH目录。Go1.11版本之后无需手动配置环境变量，使用go mod 管理项目，也不需要非得把项目放到GOPATH指定目录下，你可以在你磁盘的任何位置新建一个项目，Go1.13以后可以彻底不要GOPATH了。

    go mod init初始化项目

    实际项目开发中我们首先要在我们项目目录中用go mod命令生成一个go.mod文件管理我们项目的依赖。
    比如我们的golang项目文件要放在了itying这个文件夹，这个时候我们需要在itying文件夹里面使用go mod命令生成一个go.mod文件

    1. go mod init goProject

    Go中的包和GoMod - 图1
    然后会生成一个 go.mod 的文件，里面的内容是go版本，以及以后添加的包

    1. module goProject
    2. go 1.14

    引入其它项目的包

    首先我们创建一个 calc，然后里面有一个calc的文件

    1. package calc
    2. // 自定义包，最好和文件夹统一起来
    3. // 公有变量
    4. var age = 10
    5. // 私有变量
    6. var Name = "张三"
    7. // 首字母大写，表示共有方法
    8. func Add(x, y int)int  {
    9.   return x + y
    10. }
    11. func Sub(x, y int)int  {
    12.   return x - y
    13. }

    在其它地方需要引用的话，就是这样

    1. package main
    2. import (
    3.   "fmt"
    4.   "goProject/calc"
    5. )
    6. func main() {
    7.   fmt.Printf("%v", calc.Add(2, 5))
    8. }

    Golang中自定义包

    包（package）是多个Go源码的集合，一个包可以简单理解为一个存放多个.go文件的文件夹。该文件夹下面的所有go文件都要在代码的第一行添加如下代码，声明该文件归属的包。

    1. package 包名

    注意事项

  • 一个文件夹下面直接包含的文件只能归属一个package，同样一个package的文件不能在多个文件夹下。

  • 包名可以不和文件夹的名字一样，包名不能包含-符号。

  • 包名为main的包为应用程序的入口包，这种包编译后会得到一个可执行文件，而编译不包含main包的源代码则不会得到可执行文件。

    Go中init()初始化函数

    init函数介绍

    在Go 语言程序执行时导入包语句会自动触发包内部init（）函数的调用。需要注意的是：init（） 函数没有参数也没有返回值。init（）函数在程序运行时自动被调用执行，不能在代码中主动调用它。 包初始化执行的顺序如下图所示：
    包初始化执行的顺序如下图所示：
    Go中的包和GoMod - 图2

    init函数执行顺序

    Go语言包会从main包开始检查其导入的所有包，每个包中又可能导入了其他的包。Go编译器由此构建出一个树状的包引用关系，再根据引用顺序决定编译顺序，依次编译这些包的代码。
    在运行时，被最后导入的包会最先初始化并调用其init（）函数，如下图示：
    Go中的包和GoMod - 图3
    也就是父类中的init先执行

    Go中的第三方包

    我们可以在 https://pkg.go.dev/ 查找看常见的golang第三方包
    例如，前面找到前面我们需要下载的第三方包的地址

    1. https://github.com/shopspring/decimal

    然后安装这个包

    方法1：go get 包全名 （全局）

    1. go get github.com/shopspring/decimal

    方法2：go mod download （全局）

    1. go mod download

    依赖包会自动下载到 $GOPATH/pkg/mod目录，并且多个项目可以共享缓存的mod，注意使用go mod download的时候，需要首先在你的项目中引入第三方包

    方法3：go mod vendor 将依赖复制到当前项目的vendor（本项目）

    1. go mod vendor

    将依赖复制到当前项目的vendor下
    注意：使用go mod vendor的时候，首先需要在你的项目里面引入第三方包

    go mod常见命令

  • go mod download：下载依赖的module到本地cache

  • go edit：编辑go.mod文件
  • go graph：打印模块依赖图
  • go init：在当前文件夹下初始化一个新的module，创建go.mod文件
  • tidy：增加丢失的module，去掉未使用的module
  • vendor：将依赖复制到vendor下
  • verify：校验依赖，检查下载的第三方库有没有本地修改，如果有修改，则会返回非0，否则校验成功

    安装依赖

    首先我们先去官网找到这个包，https://github.com/shopspring/decimal
    然后在我们的项目中引入
    1. import (
    2.   "fmt"
    3.   "github.com/shopspring/decimal"
    4.   "goProject/calc"
    5. )
    6. func main() {
    7.   fmt.Printf("%v \n", calc.Add(2, 5))
    8.   // 打印公有变量
    9.   fmt.Println(calc.Name)
    10.   _, err := decimal.NewFromString("136.02")
    11.   if err != nil {
    12.       panic(err)
    13.   }
    14. }
    引入后，我们运行项目，就会去下载了，下载完成后，我们到 go.mod文件夹，能够看到依赖被引入了
    1. module goProject
    2. go 1.14
    3. require github.com/shopspring/decimal v1.2.0 // indirect
    同时还生成了一个 go.sum文件
    1. github.com/shopspring/decimal v1.2.0 h1:abSATXmQEYyShuxI4/vyW3tV1MrKAJzCZ/0zLUXYbsQ=
    2. github.com/shopspring/decimal v1.2.0/go.mod h1:DKyhrW/HYNuLGql+MJL6WCR6knT2jwCFRcu2hWCYk4o=
    这样我们就可以使用第三包开始具体的使用了~，我们实现一个Float类型的加法
    1. package main
    2. import (
    3.   "fmt"
    4.   "github.com/shopspring/decimal"
    5. )
    6. func main() {
    7.   var num1 float64 = 3.1
    8.   var num2 float64 = 4.2
    9.   d1 := decimal.NewFromFloat(num1).Add(decimal.NewFromFloat(num2))
    10.   fmt.Println(d1)
    11. }

    完整案例

    寻找依赖

    首先我们需要去 依赖官网，类似于我们的 maven repository
    Go中的包和GoMod - 图4
    然后我们搜索gJson的包，这个包主要是用于json相关的操作
    Go中的包和GoMod - 图5
    我们进去后，找到它的https://github.com/tidwall/gjson，然后提供了完整的教程
    1. # 下载依赖
    2. go get -u github.com/tidwall/gjson
    使用
    1. package main
    2. import "github.com/tidwall/gjson"
    3. const json = `{"name":{"first":"Janet","last":"Prichard"},"age":47}`
    4. func main() {
    5.   value := gjson.Get(json, "name.last")
    6.   println(value.String())
    7. }