MINO / SMALL STEPS. OPEN POSSIBILITIES.

从一个包开始。
随项目成长。

按需引入,自然组合。让服务逐步成长,始终写熟悉的 Go。

go get github.com/hainuoli/mino

Go 1.23+·MIT·零第三方运行时依赖

01

渐进式

从一个工具包到完整 HTTP 服务,按项目的节奏逐步成长。

02

轻量小巧

2,003 行生产代码,零第三方运行时依赖。

03

高性能

静态路由实测 85.5 ns/op,六组对比基准中四组领先。

04

出色的 DX

实用的默认行为、一致的组件约定,少写重复代码。

05

符合直觉

标准 HTTP handler、上下文与错误链,熟悉 Go 就能上手。

06

按需引入

需要什么就引入什么。各包独立可用,也能自然组合。

HELLO, MINO.

熟悉的 Go,
自然就会用。

标准 HTTP handler,一次调用输出 JSON。保存为 main.go,即可运行第一个 Mino 服务。

运行这个示例
main.gonet/http + Mino
package main

import (
	"log"
	"net/http"

	"github.com/hainuoli/mino/rest"
	"github.com/hainuoli/mino/rest/httpx"
)

func main() {
	mux := rest.NewMux()

	mux.Get("/", func(w http.ResponseWriter, r *http.Request) {
		httpx.OkJSON(w, "Hello, Mino!")
	})

	log.Fatal(http.ListenAndServe(":8080", mux))
}
GET /"Hello, Mino!"200 OK

01 / ROOM TO GROW

今天够用,明天从容。

渐进式使用
1

先用一个包

独立处理 JSON、包装错误,或组合已有中间件。

jsonx · errorx · mapping · chain
2

再加请求处理

按需加入绑定、验证、错误响应,保留标准 handler。

httpx.Parse → Validate → OkJSON
3

自然长成服务

围绕同一份 handler 增加路由、分组与中间件。

rest.NewMux → Route → Use

02 / AT HOME IN NET/HTTP

已有的服务,
也能轻松接入。

替换构造器,保留注册方式、handler、中间件与服务配置。需要路径清理、转义匹配或尾斜杠重定向时,再开启对应策略。

从 ServeMux 迁移
从这里开始main.go
− mux := http.NewServeMux()
+ mux := rest.NewMux()

  mux.HandleFunc("GET /users/{id}", getUser)
http.Handler→r.PathValue→原有代码继续用

03 / SMALL CODE. MEASURED SPEED.

快,有据可查。

查看测试方法

85.5ns/op

静态路由 · 本次六组基准中四组领先

88 KiB

最小路由服务相对 net/http 基线的二进制增量。

体积测量
单位 ns/op,越低越好。
场景 / ns/opMinoGinChigo-zero router
静态路由85.5101.2220.3123.4
单路径参数183.0127.0343.5385.2
三个路径参数274.5197.6499.1679.2
1,000 条路由131.3170.6355.15,328.0
五层中间件254.9279.1410.7304.4
路由 + JSON178.5217.9316.5219.5

Apple M4 · Go 1.25.4 · 五次采样的中位数 · -cpu=1 · 2026-11-15

进程内 ServeHTTP,无默认中间件;go-zero 仅使用独立路由器。

参数路由中 Gin 更快;Mino 当前写入标准 PathValue 产生额外 map 分配。 原因分析 ↗

YOUR CODE. YOUR PACE.

从你需要的那一部分开始。

写下第一个 Mino 服务