go web 工程脚手架

go-web-quickstart

• github: https://github.com/fengjx/go-web-quickstart
• gitee: https://gitee.com/fengjx/go-web-quickstart

go web 工程示例，可以作为一些项目工程结构参考，对一些常用功能做了简单封装。支持构建docker镜像。

示例中已完成了部分功能实现，方便做一些参考

• 用户登录、注册
• 博客查看、添加、删除、修改

环境依赖

• MySQL

  • 初始化sql在deployments/db
• Redis

对应配置在configs目录，可以自行修改

make 指令

$ make help
Makefile cmd:

    build:                              项目打包
    build-go:                           构建 golang 包
    fmt-go:                             格式化 golang 代码
    tidy:                               去掉未使用的项目依赖
    clean:                              清理临时文件
    help:                               Makefile 帮助

启动项目

go run cmd/main.go configs/app-local.yaml

打包

make build

打包后的可执行文件生成在.dist目录

docker

打包

# 镜像名和版本可以自己定义
docker build . -t web-app:1.0.0

启动

# APP_ENV 启用不同环境配置
docker run  -p 8080:8080 -e APP_ENV=test --name webapp web-app:1.0.0

技术选型

• gin - web 框架
• json-iterator - 高效 json 类库
• go-yaml - yaml 文件加载
• xorm - orm 框架
• go-redis redis 客户端
• lo 一个类似 lodash 的集合工具类库

工程结构

• build: 工程构建相关
• cmd: 应用启动入口
• configs: 项目配置
• deployments: 应用依赖
• init: 应用启动配置
• internal: 应用业务逻辑代码
• pkg: 放到应用外部依然能使用的代码库、工具类
• test: 测试相关
• tools: 项目工具，如代码生成脚本

参考

• go 项目分层结构