gorilla/mux 是对 net/http 的路由增强，兼容标准库、不接管 handler 生命周期；它通过路径模板（如 /users/{id}）、显式方法限制（.Methods）和 mux.Vars 提取参数来支持 REST 路由，而 http.ServeMux 仅支持前缀匹配且无法区分方法与路径参数。
gorilla/mux 不是“引入框架”，而是给 net/http 增加路由表达能力——它完全兼容标准库，不接管 handler 生命周期，也不隐藏 http.ResponseWriter 和 *http.Request。你不需要重写现有 handler，只需把 http.HandleFunc 换成 router.HandleFunc，就能立刻支持路径参数、方法限制、正则匹配等 REST 必需能力。
为什么不能直接用 http.ServeMux 实现 REST 路由
http.ServeMux 本质是前缀树（trie）匹配，只认路径前缀，无法区分 /users/123 和 /users/new；它也不检查 HTTP 方法，GET /users 和 POST /users 必须手动在 handler 内用 r.Method 分支判断，容易漏写 http.Error(w, "", http.StatusMethodNotAllowed)。
常见错误现象：
- 注册了
http.HandleFunc("/users", handler)，结果POST /users/123也进来了，但 handler 里没处理POST+ path 参数逻辑，直接 panic - 想支持
/users/{id}，却写成http.HandleFunc("/users/", handler)，导致/users（无尾斜杠）404，而/users/（有尾斜杠）又匹配到所有子路径
gorilla/mux 路由注册的三个关键动作
不是“加个包就自动 REST”，必须显式声明三件事：路径模板、HTTP 方法、参数提取方式。
- 路径模板用
{name}占位符，如/users/{id}，不是正则（除非你主动加:regex后缀） - 必须调用
.Methods("GET")或.Methods("POST", "PUT")，否则任何方法都匹配 - 参数从
mux.Vars(r)取，不是r.URL.Path手动切分 ——vars["id"]是字符串，类型转换要自己做（比如用strconv.Atoi）
示例：
立即学习“go语言免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
r := mux.NewRouter()
r.HandleFunc("/users", getUsers).Methods("GET")
r.HandleFunc("/users", createUser).Methods("POST")
r.HandleFunc("/users/{id}", getUser).Methods("GET")
r.HandleFunc("/users/{id}", updateUser).Methods("PUT")
r.HandleFunc("/users/{id}", deleteUser).Methods("DELETE")
路径参数和查询参数别混用
{id} 是路径参数，?page=1&limit=20 是查询参数，mux.Vars(r) 只管前者，后者仍要用 r.URL.Query().Get("page")。
容易踩的坑：
- 把
/users?name=alice当成/users/{name}，结果mux.Vars(r)返回空 map，查不到"name" - 路径参数名和结构体字段名不一致，比如路由写
/posts/{post_id}，但代码里硬写vars["id"]，返回""导致后续strconv.Atoi("")panic - 没校验
vars["id"]是否为空，直接传给数据库查询，可能查出全表或触发默认值逻辑
中间件注入和 panic 恢复必须自己补
gorilla/mux 不提供日志、鉴权、recover 等功能 —— 它只做路由分发。所有 handler 都是裸的 http.HandlerFunc，panic 会直接炸掉整个 goroutine。
实操建议：
- 写一个包装器函数，比如
recoveryHandler(h http.HandlerFunc) http.HandlerFunc，里面defer func()捕获 panic 并返回http.StatusInternalServerError - 不要在每个 handler 里重复写
w.Header().Set("Content-Type", "application/json")，统一在包装器里设 - 鉴权中间件放在
router.Use()里，但它只对匹配成功的路由生效；未匹配路由（404）不会经过中间件，所以 404 的响应头、格式也要单独控制
复杂点在于：路由匹配失败时，gorilla/mux 默认返回空白 404 响应体。如果你需要统一 JSON 错误格式（如 {"error": "not found"}），得调用 router.NotFoundHandler = yourNotFoundHandler 显式覆盖。
