Go-chi是轻量、可组合、兼容net/http的路由库，需显式传chi.Router给http.ListenAndServe启动；Route仅做路径前缀，Group才支持中间件嵌套；通配符路径须用{name:*}并配合strings.TrimPrefix提取带斜杠段。
Go-chi 是 Go 语言中轻量、可组合、符合 net/http 接口的路由库，它不侵入 handler 签名，也不强制中间件写法，适合中小型服务快速搭建清晰的路由结构。如果你正被 gorilla/mux 的冗余或 gin 的隐式上下文困扰，用 Go-chi 替代是合理选择——但得按它的逻辑来，否则容易掉进中间件执行顺序或路由匹配优先级的坑里。
为什么 chi.Router 不能直接用 http.ListenAndServe 启动？
因为 chi.Router 实现了 http.Handler 接口，但它本身不是 server；你必须显式传给 http.ListenAndServe。常见错误是漏掉类型转换或误以为它自带监听逻辑。
- 正确写法：
http.ListenAndServe(":8080", r)，其中r是chi.NewRouter()返回值 - 如果加了中间件（比如
chi.Middleware），确保它们返回http.Handler，而不是闭包函数本身 - 别把
r.ServeHTTP直接当 handler 传——它只是方法，不是接口实现体
chi.Route 和 chi.Group 的实际区别在哪？
两者都用于组织子路由，但语义和行为不同：chi.Route 是只读分组，不支持中间件；chi.Group 才是真正可叠加中间件、可嵌套的子路由器。
- 用
r.Group(func(r chi.Router) {...})时，内部所有路由自动继承外层中间件，且可再调用.Group嵌套 -
r.Route("/api", func(r chi.Router) {...})只做路径前缀拼接，中间件不会透传，适合静态分组隔离 - 混用时注意：Route 内部不能再调用
.Use，否则 panic 提示 “cannot use middleware on route”
如何让 chi.URLParam 正确提取带斜杠的路径段？
chi.URLParam(r, "name") 默认只取单段路径（不含 /），若 URL 是 /file/a/b/c 且你注册的是 r.Get("/file/{path}", ...)，直接取会丢掉后半部分。
立即学习“go语言免费学习笔记（深入）”；
- 解决方案：用通配符
{path:*}，然后手动截掉前缀：strings.TrimPrefix(r.URL.Path, "/file/") - 不要试图用正则匹配
{path:.*}—— chi 不支持正则路径参数，会静默忽略 - 如果必须校验格式，应在 handler 内用
path.Match或strings.HasPrefix判断，而非依赖路由层过滤
Go-chi 的简洁性来自克制的设计，但也意味着它不会帮你兜底：中间件顺序错一位、Group 和 Route 混用、通配路径没加星号，都会导致 404 或 panic 却不报具体原因。最常被忽略的是——所有中间件必须在路由注册前挂载，挂晚了就对已注册路由无效。
