Go：构建应用程序的10大框架

article/2025/9/28 10:09:26

文章目录

    • 简介
    • 一、CLI 命令(spf13/cobra)
    • 二、配置读取器(spf13/viper)
    • 三、Web 框架(labstack/echo)
    • 四、依赖注入(uber-go/fx)
    • 五、Swagger Generator, UI 和 Validation
      • 1. Swagger generator (swaggo/swag)
      • 2. Swagger UI (swaggo/echo-swagger)
      • 3. Swagger validation (go-swagger/go-swagger)
    • 六、自定义 Logger (sirupsen/logrus)
    • 七、Mock 生成器 (vektra/mockery)
    • 八、Migrate (golang-migrate/migrate)
    • 九、Messaging (NSQ)
    • 十、10、SQL (jmoiron/sqlx)
    • 十一、附加的一些库
    • 小结
      • 参考资料

简介

现在，很多开源库都支持构建应用程序。我应该向你推荐一些库，它们可以帮助启动具有简单设计、干净代码和良好性能的项目。
在这里插入图片描述

一、CLI 命令(spf13/cobra)

在这里插入图片描述

Cobra 既是一个用于创建强大的现代 CLI 应用程序的库，也是一个用于生成应用程序和命令文件的程序。我使用这个库来管理命令应用程序，执行运行程序，初始化配置，并启动 Rest API。

基于 cobra 的应用组织结构：

├── app 
│ ├── main.go 
│ ├── cmd 
│ └── root.go

app/main.go 的代码如下：

package main 
import ( "app/cmd" 
) 
func main() { cmd.Execute() 
}

app/cmd/root.go 代码如下：

package cmd 
var rootCmd = &cobra.Command{ Use:   "hugo", Short: "Hugo is a very fast static site generator", Long: `A Fast and Flexible Static Site Generator built with love by spf13 and friends in Go. Complete documentation is available at http://hugo.spf13.com`, Run: func(cmd *cobra.Command, args []string) { // Do Stuff Here }, 
} 
func Execute() { if err := rootCmd.Execute(); err != nil { fmt.Println(err) os.Exit(1) } 
}

项目地址：https://github.com/spf13/cobra。

二、配置读取器(spf13/viper)

在这里插入图片描述
iper 是 Go 应用程序的完整配置解决方案。Viper 支持以下格式配置：

  • JSON
  • TOML
  • YAML
  • HCL
  • INI
  • envfile
  • Java properties config files

例如 config/config.toml：

address="localhost" 
port="9090"

响应操作的文件 config.go：

func ReadConfig() { viper.SetConfigName("config/config.toml") viper.SetConfigType("toml") err := viper.ReadInConfig() if err != nil { panic(fmt.Errorf("Fatal error config file: %s \n", err)) } 
}

然后在 main.go 中使用 config 的值：

func main() { address := viper.Get("address") port := viper.Get("port") fmt.Printf("address: %s", address) fmt.Printf("port: %s", port) 
}

项目地址：https://github.com/spf13/viper。

三、Web 框架(labstack/echo)

在这里插入图片描述
Echo 是一个高性能、极简主义的 Go Web 框架。

安装:

// go get github.com/labstack/echo/{version} 
go get github.com/labstack/echo/v4

示例

package main import ( "net/http" "github.com/labstack/echo/v4" "github.com/labstack/echo/v4/middleware" 
) func main() { // Echo instance e := echo.New() // Middleware e.Use(middleware.Logger()) e.Use(middleware.Recover()) // Routes e.GET("/", hello) // Start server e.Logger.Fatal(e.Start(":1323")) 
} // Handler 
func hello(c echo.Context) error { return c.String(http.StatusOK, "Hello, World!") 
}

项目地址：https://github.com/labstack/echo。

四、依赖注入(uber-go/fx)

在这里插入图片描述
我发现这个库非常有用，你不需要生成任何东西。只有代码。非常模块化和清晰的层次。一个依赖注入的 Go 应用框架。

func main() { fx.New(injectModule()).Run() 
} func injectModule() fx.Option { return fx.Options( fx.Provide(  NewTimeOutContext,  NewDbConn,  ), repository.Module,  service.Module,  outbound.Module,  server.Module,  controller.Module, ) 
}

项目地址：https://github.com/uber-go/fx。

五、Swagger Generator, UI 和 Validation

在这里插入图片描述
在 swagger 部分，我必须使用不同的 3 个库，因为我没有找到 1 个库同时包含这个 3 个库功能的。如果你有推荐，请评论告知。

1. Swagger generator (swaggo/swag)

Swag 将 Go 注释转换为 Swagger Documentation 2.0。我们为流行的 Go Webb 框架[1]创建了各种各样的插件。这允许你快速集成一个现有的 Go 项目(使用 Swagger UI)。支持的 Web 框架：

  • gin
  • echo
  • buffalo
  • net/http

Swag 已经处理了你那些 swagger 文件。所以你不再需要写 swagger.yml 或 swagger.json。你需要做的只是编写注释。看一个例子：

// @title Blueprint Swagger API 
// @version 1.0 
// @description Swagger API for Golang Project Blueprint. 
// @termsOfService http://swagger.io/terms/ 
// @contact.name API Support 
// @contact.email martin7.heinz@gmail.com 
// @license.name MIT 
// @license.url https://github.com/MartinHeinz/go-project-blueprint/blob/master/LICENSE 
// @BasePath /api/v1 
func main() { ... r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler)) ... 
}

项目地址：https://github.com/swaggo/swag。

2. Swagger UI (swaggo/echo-swagger)

因为我正在使用 echo，所以我为 swagger 选择了这个 user interface。

使用示例：

package main 
import ( "github.com/labstack/echo/v4" "github.com/swaggo/echo-swagger" _ "github.com/swaggo/echo-swagger/example/docs" // docs is generated by Swag CLI, you have to import it. 
) 
// @title Swagger Example API 
// @version 1.0 
// @description This is a sample server Petstore server. 
// @termsOfService http://swagger.io/terms/ 
// @contact.name API Support 
// @contact.url http://www.swagger.io/support 
// @contact.email support@swagger.io 
// @license.name Apache 2.0 
// @license.url http://www.apache.org/licenses/LICENSE-2.0.html 
// @host petstore.swagger.io 
// @BasePath /v2 
func main() { e := echo.New() e.GET("/swagger/*", echoSwagger.WrapHandler) e.Logger.Fatal(e.Start(":1323")) 
}

项目地址：https://github.com/swaggo/echo-swagger。

3. Swagger validation (go-swagger/go-swagger)

这个包包含了 Swagger 2.0(又名 OpenAPI 2.0[2])的 golang 实现: 它知道如何序列化和反序列化 Swagger 规范。

安装：

go get github.com/go-swagger/go-swagger/cmd/swagger

运行以验证：

swagger validate api/docs/swagger.yaml

输出如下：

2021/01/30 22:47:01  
The swagger spec at "api/docs/swagger.yaml" is valid against swagger specification 2.0

项目地址：https://github.com/go-swagger/go-swagger。

六、自定义 Logger (sirupsen/logrus)

在这里插入图片描述
Logrus 是 Go (golang)的结构化 Logger，完全兼容标准库 Log。

示例：

package main import ( log "github.com/sirupsen/logrus" 
) func main() { log.WithFields(log.Fields{ "animal": "walrus", }).Info("A walrus appears") 
}

项目地址：https://github.com/sirupsen/logrus。

七、Mock 生成器 (vektra/mockery)

一个 Mock 代码自动生成器

安装：

go get github.com/vektra/mockery/v2/.../

生成 mock：

./bin/mockery --all

输出：
在这里插入图片描述
项目地址：https://github.com/vektra/mockery。

八、Migrate (golang-migrate/migrate)

用 Go 编写的数据库迁移工具。作为 CLI[3] 使用或作为库[4]导入。支持如下数据库：

  • PostgreSQL
  • Redshift
  • Ql
  • Cassandra
  • SQLite (todo #165)
  • SQLCipher
  • MySQL/ MariaDB
  • Neo4j
  • MongoDB
  • CrateDB (todo #170)
  • Shell (todo #171)
  • Google Cloud Spanner
  • CockroachDB
  • ClickHouse
  • Firebird
  • MS SQL Server

安装：

$ go get -u -d github.com/golang-migrate/migrate/cmd/migrate

创建迁移文件：

migrate create -ext sql -dir database/migrations -seq create_user

运行升级版本：

migrate -database "mysql://user:pass@tcp(localhost:3600)/user" -path=database/migrations up

降版本：

migrate -database "mysql://user:pass@tcp(localhost:3600)/user" -path=database/migrations down

项目地址：< https://github.com/golang-migrate/migrate>。

九、Messaging (NSQ)

在这里插入图片描述

NSQ 拓扑：
在这里插入图片描述

NSQ 组件：

  • nsqlookupd (daemon manage topologies / routes)
  • nsqd (daemon manage receives, queues, and delivers messages)
  • nsqadmin (default Web UI of nsq)

基于 docker-compose 示例：(nsqlookupd，nsqd，nsqadmin)

version: '3' 
services: 
nsqlookupd: 
image: nsqio/nsq 
command: /nsqlookupd 
ports: 
- "4160:4160" 
- "4161:4161" 
nsqd: 
image: nsqio/nsq 
command: /nsqd --lookupd-tcp-address=nsqlookupd:4160 
depends_on: 
- nsqlookupd 
ports: 
- "4150:4150" 
- "4151:4151" 
nsqadmin: 
image: nsqio/nsq 
command: /nsqadmin --lookupd-http-address=nsqlookupd:4161 
depends_on: 
- nsqlookupd 
ports: 
- "4171:4171"

执行：

To run docker: 
$ docker-compose up -d 
or if use name (docker-compose-nsq.yml): 
$ docker-compose -f docker-compose-nsq.yml up -d 
To check container docker: 
$ docker-compose ps 
To see logs: 
$ docker-compose logs 
To check nsq web ui: (assuming port is 32770) 
$ curl http://127.0.0.1:32770/ping

Go 代码目录：

Create Folder: 
├── consume 
│   └── consume.go 
└── publish └── publish.go

consume.go 代码：

package main 
import ( "log" "sync" "github.com/nsqio/go-nsq" 
) 
func main() { wg := &sync.WaitGroup{} wg.Add(1) decodeConfig := nsq.NewConfig() c, err := nsq.NewConsumer("My_NSQ_Topic", "My_NSQ_Channel", decodeConfig) if err != nil { log.Panic("Could not create consumer") } c.AddHandler(nsq.HandlerFunc(func(message *nsq.Message) error { log.Println("NSQ message received:") log.Println(string(message.Body)) return nil })) err = c.ConnectToNSQD("127.0.0.1:4150") if err != nil { log.Panic("Could not connect") } log.Println("Awaiting messages from NSQ topic \"My NSQ Topic\"...") wg.Wait() 
}

运行 consume.go：

$ go run consume/consume.go

publish.go 代码：

package main 
import ( "log" "github.com/nsqio/go-nsq" 
) 
func main() { config := nsq.NewConfig() p, err := nsq.NewProducer("127.0.0.1:4150", config) if err != nil { log.Panic(err) } err = p.Publish("My_NSQ_Topic", []byte("sample NSQ message")) if err != nil { log.Panic(err) } 
}

运行 publish：

$ go run publish/publish.go

项目地址：https://github.com/nsqio/go-nsq。

十、10、SQL (jmoiron/sqlx)

sqlx 是一个库，它为 go 的标准 database/sql 库提供了一组扩展。我喜欢的 sqlx 是因为它们可以 scan 结构!使用简单。

StrucScan 的例子：

place := Place{} 
rows, err := db.Queryx("SELECT * FROM place") 
for rows.Next() { err := rows.StructScan(&place) if err != nil { log.Fatalln(err) }  fmt.Printf("%#v\n", place) 
}

项目地址：https://github.com/jmoiron/sqlx。

十一、附加的一些库

  • Go routine grouping (sync/errgroup)：https://pkg.go.dev/golang.org/x/sync/errgroup
  • Fluent SQL generation for golang (Masterminds/squirrel)：https://github.com/Masterminds/squirrel
  • Golang Linter (golangci/golangci-lint)：https://github.com/golangci/golangci-lint
  • Circuit Breaker (gojek/heimdall)：https://github.com/gojek/heimdall
  • Go tool generate tags (fatih/gomodifytags)：https://github.com/fatih/gomodifytags

小结

要构建应用程序，我们应该知道有什么功能，特别是如果我们是团队协作，建议使用可读性强的代码，这样在成为遗留代码之前(也许 5-10 年之后) ，代码可以更容易维护。构建应用程序的三个关键：

  • 简单设计(项目结构和依赖关系)
  • Clean Code (可读性和可维护性)
  • Modular(模块化) (Solid & flexible skeleton)

为了封装所有这些库，我有一个模板或框架项目，其设计简单，代码清晰。看看这个：https://github.com/kecci/goscription。以上就是我常用的 10 大 Go 框架/库和一些附加库。

参考资料

  • [1]Go Webb 框架: https://github.com/swaggo/swag#supported-web-frameworks
  • [2]OpenAPI 2.0: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
  • [3]CLI: https://github.com/golang-migrate/migrate#cli-usage
  • [4]库: https://github.com/golang-migrate/migrate#use-in-your-go-project

http://chatgpt.dhexx.cn/article/YMDhxi7Q.shtml

相关文章

KgoUI（2） 之 vue + layui

KgoUI（2） 之 vue + layui

框架源代码&#xff1a;码云 我接触layui 已经快2年多了&#xff08;Layui刚出的时候我就开始关注了&#xff09;&#xff0c;vue 和 layui并不是天生一对&#xff0c;elementui 和vue配合更加亲密无间。我认为layui的弹层layer是当前前端最好的弹层。 这里依旧选择layu…
阅读更多...
2021年全国大学生网络安全邀请赛暨第七届“东华杯“上海市大学生网络安全大赛Writeup

2021年全国大学生网络安全邀请赛暨第七届“东华杯“上海市大学生网络安全大赛Writeup

2021年全国大学生网络安全邀请赛暨第七届"东华杯"上海市大学网格全大赛Writeup Misc checkin 题目给了AGYAbABhAGcAewBkAGgAYgBfADcAdABoAH0- 是UTF-7编码&#xff0c;解码得到flag flag为&#xff1a; flag{dhb_7th}project 下载附件&#xff0c;解压之后发现这…
阅读更多...
玩转Kafka—SpringGo整合Kafka

玩转Kafka—SpringGo整合Kafka

玩转Kafka—Spring整合Kafka 1 新建Spring Boot项目&#xff0c;增加依赖 <dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependenc…
阅读更多...
视图单行子查询返回mysql,Oracle命令整理 - osc_sj1kgo4z的个人空间 - OSCHINA - 中文开源技术交流社区...

视图单行子查询返回mysql,Oracle命令整理 - osc_sj1kgo4z的个人空间 - OSCHINA - 中文开源技术交流社区...

常用命令 1 sqlplus scott/tiger192.168.47.10:1521/orcl后面不要加&#xff1b; sqlplus sys/oracle as sysdba 【密码认证】 sqlplus用户名任意/密码任意as sysdba 【主机认证】 2 spool d:\基本查询.txt 录屏开始 spool off …
阅读更多...
MLX90316KGO-BDG-100-RE传感器 旋转位置 角度测量

MLX90316KGO-BDG-100-RE传感器 旋转位置 角度测量

介绍 MLX90316是Tria⊗is旋转位置传感器&#xff0c;提供在设备表面旋转的小偶极磁铁(轴端磁铁)的绝对角位置。 得益于其表面的集成磁集中器(IMC)&#xff0c;单片设备以非接触式方式感知应用磁通量密度的水平分量。 这种独特的传感原理应用于旋转位置传感器&#xff0c;可在机…
阅读更多...
图形语言 Kgo

图形语言 Kgo

http://www.ferlysoft.com/product-kgo.asp 始于2008 无代码开发技术&#xff0c;以图形取代编程 Kgo 介绍Kgo是无代码开发管理信息系统的特定领域语言。 Kgo语言由语法语义、图形设计云工具和运行时环境三个部分构成。Kgo 语法语义采用XSD&#xff08;XML Schemas Definition&…
阅读更多...
KgoUI 页面展示

KgoUI 页面展示

前端框架 vue layui sass 框架源代码&#xff1a;码云
阅读更多...
微软账号登陆不上_微软待办（todo）如何跟Outlook任务同步？

微软账号登陆不上_微软待办（todo）如何跟Outlook任务同步？

小生我之前也遇到这个问题了&#xff0c;后来参考了知友的一个答案&#xff0c;自此得到了解决 但是也还是由很多人不太明白&#xff0c;所以我尝试着把我解决这个问题的关键点描述一下&#xff0c;希望能给大家一些帮助 关键点只有一个&#xff1a; 三个软件的账户一定要一样 …
阅读更多...
微软HPC解决方案

微软HPC解决方案

首先我们先来看下高性能群集与其它几种群集的不同 高可用群集&#xff1a;群集所有节点&#xff0c;来维持一个应用的持续运作&#xff0c;如果当前应用所在节点失败&#xff0c;自动故障转移至其它节点 负载均衡群集&#xff1a;群集所有节点来平衡一个应用的访问请求&#x…
阅读更多...
群辉服务器间同步文件,群晖NAS端之间同步（Cloud Station Sharesync)

群辉服务器间同步文件,群晖NAS端之间同步（Cloud Station Sharesync)

Cloud Station套件是一个套件组&#xff0c;包含5个功能模块&#xff0c;其中Cloud Station Server是Cloud Station在NAS上的服务器端&#xff1b;云同步(Cloud Station Drive)和云备份(Cloud Station Backup)是电脑端软件&#xff0c;Drive是电脑端和NAS端的双向同步&#xff…
阅读更多...
微软官方硬盘备份软件SyncToy

微软官方硬盘备份软件SyncToy

微软官方硬盘备份软件SyncToy 前言 最近用硬盘检测工具发现硬盘坏道有点多&#xff0c;状态不佳&#xff0c;折腾了一阵还差点把硬盘搞坏&#xff0c;好在重装系统解决了问题&#xff08;重装大法好&#xff09;。再加上现在网上对资源限制越来愈大&#xff0c;所以对数据安全…
阅读更多...
微软同步工具之synctoy

微软同步工具之synctoy

&#xfeff;&#xfeff; synctoy是由 微软 推出的一款免费的文件夹同步工具。微软的软件都以复杂与臃肿著称&#xff0c;不过这款软件还真是摆脱了复杂和臃肿。 &#xff1a;第一項是最主要的雙向同步功能&#xff0c;會依據左右兩端點裡檔案的增加、刪除、修改、更名&#x…
阅读更多...
软件工程测试题

软件工程测试题

学堂在线选择题汇总 初识软件工程 软件工程方法是&#xff08; &#xff09;。 为了获得高质量软件而实施的一系列活动为开发软件提供技术上的解决方法为支持软件开发、维护、管理而研制的计算机程序系统为了理解问题和确定需求而采取的一些技术和方法下面的&#xff08; &am…
阅读更多...
远程桌面同步本地计算机,微软更新远程桌面应用现在终于可以在本地和远程计算机上复制文件...

远程桌面同步本地计算机,微软更新远程桌面应用现在终于可以在本地和远程计算机上复制文件...

远程桌面连接是许多专业用户和开发者必备的功能&#xff0c;通过远程桌面服务可以直接连接远程计算机并可以直接操作。 系统自带的远程桌面连接程序微软已经很久没有更新&#xff0c;因为微软现在主要通过应用商店发布新版本远程桌面应用。 比如在刚刚发布的远程桌面应用新版本…
阅读更多...
解决 vscode 登录微软账户同步设置 出现“vscode.dev 关闭了连接“ 问题

解决 vscode 登录微软账户同步设置 出现“vscode.dev 关闭了连接“ 问题

我的电脑最近重装了系统&#xff0c;之前的软件都删除了&#xff0c;在重新安装vscode之后想同步之前的设置、主题时出现了问题。 我的解决方法是 在当前页面 输入 https://vscode.dev 看能不能打开。 如果能打开&#xff0c;再次点击vscode登录账号同步设置 我之前使用微软账…
阅读更多...
微软应用商店_微软商店那些好用的UWP软件！你不看这篇文章会后悔的！超级实用！ | APP杂货店...

微软应用商店_微软商店那些好用的UWP软件！你不看这篇文章会后悔的！超级实用！ | APP杂货店...

作为一个前 Windows phone 用户，一直对微软应用商店(Microsoft Store)有特殊的感情，犹记得大一时天天活跃在爱应用、微疯客、IT之家只为盼着 wp应用能慢慢赶上其它平台，当微软推出uwp(Universal Windows Platform)应用时，更是感觉微软要成了，wp不会再小众了。 微软画饼 然…
阅读更多...
FreeFileSync 免费文件同步软件 实时自动备份重要资料

FreeFileSync 免费文件同步软件 实时自动备份重要资料

重要资料&#xff0c;必需备份。狡兔还有三窟呢&#xff0c;更不说突然断电就可能OVER的硬盘。 但要用的资料时时时更新的&#xff0c;对于比较小的文档&#xff0c;我们可以按日期多备份几次。如&#xff1a; 备份文档 2017-12-04 备份文档 2018-01-01 备份文档 2018-10-05 ……
阅读更多...
自动与时间服务器时间同步,Windows系统时间同步(附时间同步服务器地址)

自动与时间服务器时间同步,Windows系统时间同步(附时间同步服务器地址)

eProvidersNtpClient ] 分支&#xff0c;并双击 SpecialPollInterval 键值&#xff0c;将对话框中的“基数栏”选择到“十进制”上&#xff0c;如图1所示 图 1 3. 而这时在对话框中显示的数字正是自动对时的间隔(以秒为单位)&#xff0c;比如默认的604800就是由7(天)24(时)60(分…
阅读更多...
如何让微软Onedrive同步其他硬盘的文件

如何让微软Onedrive同步其他硬盘的文件

最近在工作中&#xff0c;有同事发现Onedriver只能同步自己文件夹中的数据。其他硬盘的数据不同步&#xff0c;发现好恼火。 因为OneDrive在默认文件夹下&#xff0c;无法对其他文件夹备份&#xff0c;进行同步备份。 今天我们就来解决这个同步的麻烦&#xff01;&#xff01; …
阅读更多...
微软drive服务器,OneDrive：微软云存储服务

微软drive服务器,OneDrive：微软云存储服务

OneDrive&#xff0c;全名Microsoft OneDrive&#xff0c;前称Windows Live SkyDrive&#xff0c;是微软所推出的网络硬盘及云存储服务。用户可以上传他们的文件到网络服务器上&#xff0c;并且透过网络浏览器来浏览那些文件。更可直接编辑和观看Microsoft Office文件。同时推出…
阅读更多...
推荐文章

Copyright @ 2022~2023