Maltose

基于 Gin 打造的轻量级、企业级 Go Web 开发框架

查看文档 · 提交 Bug · 功能需求

Maltose 是一款基于 Gin 设计的、旨在提升团队开发效率和代码质量的 Go Web 框架。它通过约定优于配置、清晰的分层架构和强大的代码生成工具，帮助开发者快速构建可维护、可扩展的企业级应用。

核心特性

• 🚀 高性能: 基于 Gin 核心，保证了卓越的路由和中间件性能。
• 🧱 模块化设计: 清晰的模块划分，如 mhttp, mcfg, mlog, mdb，易于扩展和替换。
• 🔧 代码生成: 内置强大的 CLI 工具，可一键生成 model, dao, service 等业务代码。
• 🔭 可观测性: 原生集成 OpenTelemetry，提供开箱即用的链路追踪和指标监控能力。
• 🤝 Gin 生态兼容: 完全兼容海量的 Gin 中间件，无缝迁移。
• 📚 文档完备: 提供内容详尽、结构清晰的官方文档。

快速开始

安装

go get -u github.com/graingo/maltose

创建项目

我们强烈建议您通过 maltose-quickstart 模板来开始您的新项目，它已经为您配置好了推荐的项目结构。

# 克隆快速启动模板
git clone https://github.com/graingo/maltose-quickstart.git my-app

# 进入项目目录
cd my-app

# (重要) 修改 go.mod 中的模块名为您自己的项目路径
go mod edit -module "your/module/path"

# 整理依赖
go mod tidy

# 运行
go run main.go

了解更多

我们强烈建议您阅读 官方文档 以获得关于框架的完整介绍、核心概念、组件使用和高级特性的详细指南。

设计参考

Maltose 在设计上深受优秀的开源项目 GoFrame 的启发，我们对其在模块化、接口化、工程化方面的设计哲学表示敬意和感谢。

与 GoFrame 追求大而全的全功能套件不同，Maltose 的目标是成为一个更加 轻量级、专注 的框架。我们选择基于拥有庞大生态和高性能的 Gin 作为 Web 核心，专注于后端 API 的开发场景，致力于为开发者提供一套既有 GoFrame 工程化优点，又能充分享受 Gin 生态红利的开发体验。

致谢

Maltose 的诞生离不开以下优秀开源项目的启发和支持：

• GoFrame: 提供了卓越的工程化思想和分层架构设计的灵感。
• Gin: 提供了稳定、高性能的 Web 核心。

在此向以上项目及其所有贡献者表示诚挚的感谢！

贡献

我们欢迎任何形式的贡献！您可以：

• 提交 Bug 或提出功能建议 Issues.
• 通过 Pull Requests 提交您的代码。

许可证

MIT 许可证