chi.Router() 必须用 chi.NewRouter() 初始化，因其是接口而非结构体；中间件需在路由注册前调用 Use；路径参数须用 chi.URLParam 提取；嵌套路由应使用 Group() 而非字符串拼接。
chi.Router() 必须显式调用 chi.NewRouter()，不能直接用 struct 字面量
很多人写 router := chi.Router{} 以为能用，结果 panic：nil pointer dereference。chi 的 chi.Router 是接口类型，不是结构体；实际要用工厂函数初始化。
-
chi.NewRouter()返回的是内部实现的指针（*mux），它实现了chi.Router接口，所有方法都基于这个实例 - 直接赋值 struct 字面量会丢失方法绑定，且字段未初始化，
Use、Get等调用立刻崩溃 - 如果想复用路由逻辑，应封装成函数返回
chi.Router，而不是尝试“构造”它
正确写法：
router := chi.NewRouter()
router.Get("/health", healthHandler)
中间件顺序错位导致 panic: runtime error: invalid memory address
chi 中间件执行顺序严格依赖注册顺序，尤其 chi.Middleware 和 chi.With 混用时容易出错。常见现象是 handler 里访问 r.Context().Value(...) 得到 nil，后续强制类型断言 panic。
- 全局中间件（
router.Use()）在子路由前注册才生效；后加的不会影响已注册的子路由 -
chi.With()创建的是带新中间件栈的子路由器，但它的中间件只对自身Handle生效，不透传给嵌套的Mount或Group - 日志、恢复（
recover）、JWT 验证这类中间件必须放在最外层，否则可能根本没机会执行
典型错误：
立即学习“go语言免费学习笔记（深入）”；
router := chi.NewRouter()
router.Get("/api/user", userHandler) // 此处无中间件
router.Use(loggingMiddleware, authMiddleware) // 太晚了，对上面那行无效
路径参数提取必须用 chi.URLParam(r, "name")，别碰 r.URL.Query()
chi 不会自动把 URL 路径参数（如 /user/{id}）塞进 r.URL.Query()，新手常在这里卡住，查 r.URL.Query().Get("id") 总是空。
- 路径参数和查询参数完全隔离：
/user/123?format=json中，"123"是路径参数，"json"是查询参数 -
chi.URLParam(r, "id")是唯一安全提取方式；它从 chi 内部路由匹配结果中读，不依赖 URL 解析 - 如果参数名拼错（比如写成
"ID"但路由定义是{id}），chi.URLParam返回空字符串，不会 panic —— 但你要自己判空
示例：
router.Get("/user/{id}", func(w http.ResponseWriter, r *http.Request) {
id := chi.URLParam(r, "id") // ✅ 正确
// idStr := r.URL.Query().Get("id") // ❌ 总是 ""
})
嵌套路由用 router.Group()，别手动拼接路径字符串
手写 router.Get("/api/v1/users", ...) 看似简单，但一旦要加统一前缀（比如加 /admin）、切分模块或复用中间件，就难维护。chi 提供 Group() 就是为这事设计的。
-
Group()返回新子路由器，所有注册在其上的路由自动加上前缀，且可独立挂载中间件 - 不要用字符串拼接路径（如
prefix + "/users"），那样绕过了 chi 的路径树匹配逻辑，可能导致404或中间件漏执行 -
Mount()适合挂载完整子服务（如另一个chi.Router实例），Group()更轻量，适合同一服务内逻辑分组
推荐写法：
v1 := router.Group("/api/v1")
v1.Use(authMiddleware)
v1.Get("/users", listUsers)
v1.Post("/users", createUser)
chi 的路由树是运行时构建的，所有路径匹配、中间件注入、参数提取都依赖这个结构。漏掉 NewRouter()、错放 Use()、误用参数提取方式，都会让整个链路在某个环节静默失效——不是报错，而是行为不符合预期。这点比 net/http 更隐蔽，调试时得盯着 chi.URLParam 和中间件注册位置看。 
