gin路由比net/http.servemux快因采用radix树实现o(1)匹配，而servemux为o(n)顺序遍历；gin仅支持:id和*filepath两种参数语法，注册顺序不影响匹配，中间件执行为洋葱模型。
为什么 Gin 的路由匹配比 net/http.ServeMux 快
因为 Gin 用 Radix 树（压缩前缀树）做路径查找，时间复杂度接近 O(1)；而 net/http.ServeMux 是顺序遍历 es []muxEntry，最坏情况是 O(n)。当路由数超过 50 条，延迟差异就明显了。
常见错误现象：GET("/user/{id}") 或 GET("/user/*id") 写法会 404 —— Gin 只识别 :id（单段）和 *filepath（多段、必须末尾）两种语法。
-
:id匹配/user/123中的123，不能含斜杠 -
*filepath匹配/static/css/main.css整个剩余路径，且只能出现在路由末尾 - 注册顺序不影响匹配结果：Radix 树构建后节点已固化，不是靠“先注册优先”
Gin 中间件执行顺序不是线性而是洋葱模型
写 engine.Use(m1, m2) 后再注册 router.GET("/api", handler)，实际执行流是：m1 前置 → m2 前置 → handler → m2 后置 → m1 后置。
关键在 c.Next()：它不是“调用下一个中间件”，而是“让控制权往下走，等整个链返回后再继续执行 c.Next() 后面的代码”。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 在
c.Next()之后读c.Writer.Status()或c.Writer.Size()会得到0—— 因为响应尚未真正写出，c.Writer是 wrapper，真实写入发生在链结束时 - 要用
c.Writer.StatusWritten判断响应头是否已发 - 想跳过后续中间件，用
c.Abort()；想终止并返回 JSON 错误，用c.AbortWithStatusJSON(401, ...)
中间件里存取数据，key 类型必须是 interface{}
直接传字符串当 key（比如 c.Set("user_id", 123)）看似方便，但极易冲突 —— 多个中间件都用 "user_id"，后者会覆盖前者。
安全做法是定义私有类型作 key：
type userIDKey struct{}
...
c.Set(userIDKey{}, 123)
if id, ok := c.Get(userIDKey{}).(int); ok { ... }
- 全局中间件用
engine.Use()，只对 engine 启动后注册的所有路由生效 - 路由组中间件用
group.Use()，优先级高于全局中间件（更靠近 handler） - 不要依赖
context.WithValue传业务数据 —— Gin 的c.Set/c.Get已封装好生命周期，且与请求绑定
自定义中间件里别忘了检查 panic 和 error
中间件里没 recover 的 panic 会导致整个 HTTP server 崩溃，尤其在日志、鉴权、参数校验等环节容易触发。
标准做法是在中间件开头加 defer recover：
func safeMiddleware(next gin.HandlerFunc) gin.HandlerFunc {
return func(c *gin.Context) {
defer func() {
if err := recover(); err != nil {
c.AbortWithStatusJSON(500, gin.H{"error": "internal server error"})
log.Printf("panic: %v", err)
}
}()
next(c)
}
}
- HTTP 状态码不能只靠
http.Error—— Gin 中要统一用c.AbortWithStatus或c.JSON，否则c.Next()还会继续执行 - 中间件中修改
c.Request（如重写 URL、Header）必须用c.Request = c.Request.Clone(c.Request.Context())，否则并发下可能出错 - 所有中间件都应支持
context.Context超时传递，避免阻塞 goroutine
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
