关于golang:Go-日常开发常备第三方库和工具

人不知; 鬼不觉写 Go 曾经快一年了，上线了大大小小好几个我的项目；心态也经验了几轮变动。

因为我集体大略前五年工夫写的是 Java，中途写过一年多的 Python，所以刚接触到 Go 时的感觉如下图：

既没有 Java 的生态，也没有 Python 这么多语法糖。

写到当初的感觉就是：

这里就不探讨这几门语言谁强谁弱了；重点和大家分享下咱们日常开发中所应用到的一些第三方库与工具。

这里我次要将这些库分为两类：

业务开发
根底工具开发

首先是业务开发，次要蕴含了 web、数据库、Redis 等。

首先是 Gin，一款 HTTP 框架，应用简略、性能优良、材料泛滥；你还在犹豫抉择哪款框架时，那就抉择它吧，根本没错。

当然和它配套的 github.com/swaggo/gin-swagger swagger 工具也是刚需；利用它能够生成 swagger 文档。

GORM 也没啥好说的，如果你喜爱 orm 的形式操作数据库，那就选它吧；同样的也是应用简略、材料较多。

如果有读写拆散需要，也能够应用 GORM 官网提供的插件 https://github.com/go-gorm/dbresolver，配合 GORM 应用也是非常简单。

Go 语言本身提供的错误处理比较简单，https://github.com/pkg/errors 提供了更弱小的性能，比方：

包装异样
包装堆栈等。

罕用的有以下 API：

// WithMessagef annotates err with the format specifier.
func WithMessagef(err error, format string, args ...interface{}) error

// WithStack annotates err with a stack trace at the point WithStack was called.
func WithStack(err error) error

Go 里的日志打印库十分多，日志在日常开发中最好就是存在感低；也就是说性能强（不能影响到业务代码）、应用 API 简略。

"github.com/rs/zerolog/log"
log.Debug().Msgf("OrderID :%s", "12121")

https://github.com/qax-os/excelize 是一个读写 Excel 的库，基本上你能遇到的 Excel 操作它都能实现。

https://github.com/jinzhu/now 是一个工夫工具库：

获取以后的年月日、时分秒。
不同时区反对。
最初一周、最初一个月等。

import "github.com/jinzhu/now"

time.Now() // 2013-11-18 17:51:49.123456789 Mon

now.BeginningOfMinute()        // 2013-11-18 17:51:00 Mon
now.BeginningOfHour()          // 2013-11-18 17:00:00 Mon
now.BeginningOfDay()           // 2013-11-18 00:00:00 Mon
now.BeginningOfWeek()          // 2013-11-17 00:00:00 Sun
now.BeginningOfMonth()         // 2013-11-01 00:00:00 Fri
now.BeginningOfQuarter()       // 2013-10-01 00:00:00 Tue
now.BeginningOfYear()          // 2013-01-01 00:00:00 Tue

now.EndOfMinute()              // 2013-11-18 17:51:59.999999999 Mon
now.EndOfHour()                // 2013-11-18 17:59:59.999999999 Mon
now.EndOfDay()                 // 2013-11-18 23:59:59.999999999 Mon
now.EndOfWeek()                // 2013-11-23 23:59:59.999999999 Sat
now.EndOfMonth()               // 2013-11-30 23:59:59.999999999 Sat
now.EndOfQuarter()             // 2013-12-31 23:59:59.999999999 Tue
now.EndOfYear()                // 2013-12-31 23:59:59.999999999 Tue

now.WeekStartDay = time.Monday // Set Monday as first day, default is Sunday
now.EndOfWeek()                // 2013-11-24 23:59:59.999999999 Sun

当业务上须要精度计算时 https://github.com/shopspring/decimal 能够帮忙。

import (
    "fmt"
    "github.com/shopspring/decimal"
)

func main() {price, err := decimal.NewFromString("136.02")

    quantity := decimal.NewFromInt(3)
    fee, _ := decimal.NewFromString(".035")
    taxRate, _ := decimal.NewFromString(".08875")

    subtotal := price.Mul(quantity)

    preTax := subtotal.Mul(fee.Add(decimal.NewFromFloat(1)))

    total := preTax.Mul(taxRate.Add(decimal.NewFromFloat(1)))

    fmt.Println("Subtotal:", subtotal)                      // Subtotal: 408.06
    fmt.Println("Pre-tax:", preTax)                         // Pre-tax: 422.3421
    fmt.Println("Taxes:", total.Sub(preTax))                // Taxes: 37.482861375
    fmt.Println("Total:", total)                            // Total: 459.824961375
    fmt.Println("Tax rate:", total.Sub(preTax).Div(preTax)) // Tax rate: 0.08875
}

基本上你能想到的精度转换它都能做到；配合上 GORM 也能够将 model 字段申明为 decimal 的类型，数据库对应的也是 decimal，这样应用起来时会更不便。

Amount decimal.Decimal `gorm:"column:amout;default:0.0000;NOT NULL" json:"amout"`

https://github.com/jinzhu/configor 是一个配置文件读取库，反对 YAML/JSON/TOML 等格局。

https://github.com/patrickmn/go-cache 是一个相似于 Java 中的 Guava cache，线程平安，应用简略；不须要分布式缓存的简略场景能够思考。

    c := cache.New(5*time.Minute, 10*time.Minute)
    // Set the value of the key "foo" to "bar", with the default expiration time
    c.Set("foo", "bar", cache.DefaultExpiration)

https://github.com/jinzhu/copier 看名字就晓得这是一个数据复制的库，与 Java 中的 BeanUtils.copy() 相似；能够将两个字段雷同但对象不同的 struct 进行数据复制，也反对深拷贝。

func Copy(toValue interface{}, fromValue interface{}) (err error)

在咱们须要一个长期 struct 来存放数据时很有用，特地是一个 struct 中字段十分多时，一个个来回赋值的确有点费手指。

但也要留神不要什么状况都应用，会带来一些弊病：

当删除字段时，不能利用编译器提醒。
当一些字段须要额定人工解决时，代码不易浏览。
反射赋值，有肯定性能损耗。

总之在业务开发时，还是倡议人工编写，毕竟代码是给人看的。

https://github.com/caarlos0/env 这个库能够将咱们的环境变量转换为一个 struct.

type config struct {Home string `env:"HOME"`}

func main() {cfg := config{}
    if err := env.Parse(&cfg); err != nil {fmt.Printf("%+v\n", err)
    }

    fmt.Printf("%+v\n", cfg)
}

这个在咱们打包代码到不同的运行环境时十分有用，利用它能够不便的获取不同环境变量。

https://github.com/mssola/user_agent 是一个格式化 user-agent 的小工具。

当咱们须要在服务端收集 user-agen 时能够更快的读取数据。

func main() {ua := user_agent.New("Mozilla/5.0 (Linux; U; Android 2.3.7; en-us; Nexus One Build/FRF91) AppleWebKit/533.1 (KHTML, like Gecko) Version/4.0 Mobile Safari/533.1")

    fmt.Printf("%v\n", ua.Mobile())   // => true
    fmt.Printf("%v\n", ua.Bot())      // => false
    fmt.Printf("%v\n", ua.Mozilla())  // => "5.0"
    fmt.Printf("%v\n", ua.Model())    // => "Nexus One"
    fmt.Printf("%v\n", ua.Platform()) // => "Linux"
    fmt.Printf("%v\n", ua.OS()) 
    }

https://github.com/nyaruka/phonenumbers 手机号码验证库，能够不必本人写正则表达式了。

// parse our phone number
num, err := phonenumbers.Parse("6502530000", "US")

接下来是一些根底工具库，蕴含一些支流的存储的客户端、中间件等。

github.com/agiledragon/gomonkey 是一个 mock 打桩工具，当咱们写单元测试时，须要对一些非接口函数进行 mock 会比拟艰难，这时就须要用到它了。

因为它是批改了调用对应函数时机器跳转指令，而 CPU 架构的不同对应的指令也不同，所以在咱们应用时还不兼容苹果的 M1 芯片，不过目前应该曾经兼容了，大家能够试试。

https://github.com/smartystreets/goconvey 也是配合单元测试的库，能够兼容 go test 命令。

提供可视化 web UI。
与 IDE 集成显示单元覆盖率。

https://github.com/uber-go/dig 这是一个依赖注入库，咱们这里暂不探讨是否应该应用依赖注入，至多目前咱们应用下来还是有几个益处：

所有的对象都是单例。
有一个对立的中央治理对象。
应用时间接传递对象当做参数进来即可（容器会主动注入）。

当然也有一些不太不便的中央：

不相熟时，一个对象是如何创立的不分明。
代码不是很好了解。

咱们外部有本人开发一个业务框架，其中所有的对象都交由 dig 进行治理，应用起来倒也是比拟不便。

https://github.com/spf13/cobra 是一个功能强大的命令行工具库，咱们用它来实现外部的命令行工具，同时也举荐应用 https://github.com/urfave/cli/ 我集体会更习惯用后者，要简洁一些。

https://github.com/uw-labs/bloomrpc 一个 gRPC 可视化工具，比起本人写 gRPC 客户端的代码那的确是要简略许多。

但也有些小问题，比方精度。如果是 int64 超过了 2^56 服务端拿到的值会产生谬误，这点目前还未解决。

https://github.com/go-redis/redis/ Redis 客户端，没有太多可说的；倒退了许多年，该有的的性能都有了。

https://github.com/olivere/elastic 这也是一个十分成熟的 elasticsearch 库。

https://github.com/go-resty/resty/ 一个 http client, 应用起来非常简单：

// Create a Resty Client
client := resty.New()
resp, err := client.R().
    EnableTrace().
    Get("https://httpbin.org/get")

有点 Python requests 包那味了。

Pulsar 官网出品的 go 语言客户端，绝对于 Java 来说其余语言的客户端简直都是后娘养的；性能会比拟少，同时更新也没那么踊跃；但却没得选。

https://github.com/grpc-ecosystem/go-grpc-middleware 官网提供的 gRPC 中间件，能够本人实现外部的一些鉴权、元数据、日志等性能。

https://github.com/pilosa/go-pilosa 是一个位图数据库的客户端，位图数据库的场景利用比拟无限，通常是有标签需要时才会用到；比方求 N 个标签的交并补集；数据有肯定规模后经营肯定会提相干需要；能够备着以备不时之需。

https://github.com/cheggaaa/pb 一个命令行工具进度条，编写命令行工具时应用它交互会更优雅。

最初我汇总了一个表格，不便查看：

名称	类型	性能	星级
Gin	业务开发	`HTTP` 框架	⭐️⭐️⭐️⭐️⭐️
GORM	业务开发	`ORM` 框架	⭐️⭐️⭐️⭐️⭐️
errors	业务开发	异样解决库	⭐️⭐️⭐️⭐️⭐️
zorolog	业务开发	日志库	⭐️⭐️⭐️⭐️⭐️
excelize	业务开发	`Excel` 相干需要	⭐️⭐️⭐️⭐️⭐️
now	业务开发	工夫解决	⭐️⭐️⭐️⭐️️
Decimal	业务开发	精度解决	⭐️⭐️⭐️⭐️️
configor	业务开发	配置文件	⭐️⭐️⭐️⭐️️
go-cache	业务开发	本地缓存	⭐️⭐️⭐️
copier	业务开发	数据复制	⭐️⭐️⭐️️️
env	业务开发	环境变量	⭐️⭐️⭐️️️
user_agent	业务开发	读取 `user-agent`	⭐️⭐️⭐️️️
phonenumbers	业务开发	手机号码验证	⭐️⭐️⭐️️️
gomonkey	根底工具	`mock` 工具	⭐️⭐️⭐️⭐️⭐
goconvey	根底工具	单测覆盖率	⭐️⭐️⭐️⭐️⭐
dig	根底工具	依赖注入	⭐️⭐️⭐️⭐️⭐
cobra	根底工具	命令行工具	⭐️⭐️⭐️⭐
cli	根底工具	命令行工具	⭐️⭐️⭐️⭐
BloomRPC	根底工具	`gRPC` 调试客户端	⭐️⭐️⭐️⭐
redis	根底工具	Redis 客户端	⭐️⭐️⭐️⭐
elastic	根底工具	`elasticsearch` 客户端	⭐️⭐️⭐️⭐
resty	根底工具	http 客户端	⭐️⭐️⭐️⭐
pulsar-client-go	根底工具	`Pulsar` 客户端	⭐️⭐️⭐️
go-grpc-middleware	根底工具	`gRPC` 中间件	⭐️⭐️⭐
go-pilosa	根底工具	`pilosa` 客户端	⭐️⭐️⭐️
pb	根底工具	命令行工具进度条	⭐️⭐️⭐️

星级评分的规定次要是看理论应用的频次。

最初夹带一点私货（其实也谈不上）
文中提到了咱们外部有基于以上库整合了一个业务开发框架；也基于该框架上线了大大小小 10 几个我的项目，改良空间仍然不少，目前还是在疾速迭代中。

大略的用法，入口 main.go:

最初截取我在外部的分享就概括了整体的思维 -- 援用自公司一司姓共事 。

兴许咱们外部通过屡次迭代，感觉有能力凋谢进去给社区带来一些帮忙时也会尝试开源；现阶段就不嫌丑了。

这些库都是咱们日常开发最罕用到的，也欢送大家在评论区留下你们罕用的库与工具。

关于golang:Go-日常开发常备第三方库和工具

业务开发

Gin ⭐️⭐️⭐️⭐️⭐️

GORM ⭐️⭐️⭐️⭐️⭐️

errors ⭐️⭐️⭐️⭐️⭐️

zorolog ⭐️⭐️⭐️⭐️⭐️

excelize

now ⭐️⭐️⭐️⭐️

Decimal ⭐️⭐️⭐️⭐️

configor ⭐️⭐️⭐️⭐️

go-cache ⭐️⭐️⭐️

copier ⭐️⭐️⭐️

env ⭐️⭐️⭐️

user_agent ⭐️⭐️⭐️

phonenumbers ⭐️⭐️⭐️

根底工具

gomonkey ⭐️⭐️⭐️⭐️⭐️

goconvey ⭐️⭐️⭐️⭐️⭐️

dig ⭐️⭐️⭐️⭐️⭐️

cobra ⭐️⭐️⭐️⭐️

BloomRPC ⭐️⭐️⭐️⭐️

redis ⭐️⭐️⭐️⭐️

elastic ⭐️⭐️⭐️⭐️

resty ⭐️⭐️⭐️⭐️

pulsar-client-go ⭐️⭐️⭐️

go-grpc-middleware ⭐️⭐️⭐️

go-pilosa ⭐️⭐️⭐️

pb ⭐️⭐️⭐️

总结