go-gin-web项目展示了如何从零开始搭建一个基于Go和Gin框架的工程化实践，包含项目结构、日志组件、数据库连接、错误码设计、代码生成等内容。

采用标准的Go项目结构，包含cmd、internal、pkg、log等目录。目录结构如下：

go-gin-web
├── cmd
│   ├── app
│   └── genCode
├── internal
│   ├── app
│   ├── genCode
│   ├── pkg
│   └── resource
├── log
├── pkg
├── .gitignore
├── Dockerfile
├── go.mod
├── LICENSE
└── README.md

支持链路追踪功能，确保日志可以完整地记录请求的全链路信息。

支持MySQL和Redis，均支持日志链路追踪。

设计统一的错误码管理，并对错误进行封装处理。

GinRender 组件用于统一处理 HTTP 响应，确保响应格式一致。

• 标准化响应格式：所有HTTP响应均采用统一的格式，包含状态码、消息和数据。
• 错误处理：自动捕捉和处理错误，将错误信息以标准格式返回给客户端。

支持按模块生成、只生成Model层代码、按API接口生成等。

开发者可以通过调整配置文件来生成代码，生成后各层级代码自动补全，只需关心业务代码。

安装swag工具

go install github.com/swaggo/swag/cmd/swag@latest

生成接口文档

swag init -g ./cmd/app/main.go

访问接口文档 访问 http://localhost:8099/app/swagger/index.html 即可查看接口文档。

构建镜像

docker buildx build -t go-gin-web .

运行容器

docker run -itd --name go-gin-web -p 8099:8099 go-gin-web

安装go-cutter

go install github.com/morehao/go-cutter@latest

在 当前项目根目录下（即./） 执行命令

go-cutter -d /goProject/yourAppName

执行后，会以当前项目为模板项目，在/goProject目录下生成一个名为yourAppName的项目。

go-cutter是我实现的一个快速生成项目代码的命令行工具，可以基于本项目快速生成一个新的项目，具体使用方法请参考 https://github.com/morehao/go-cutter。

• httpClient封装（支持日志链路追踪）
• Makefile文件

相关组件均在go-tools包中实现。