Go标准库http.HandleFunc不支持路径参数，仅做前缀匹配；正确做法是注册带尾斜杠的前缀（如"/products/"），再在handler内手动解析剩余路径段。
HandleFunc 绑定的是 HTTP 处理函数，不是“路由”本身
Go 标准库 http.HandleFunc 并不支持路径参数、通配符或子路由——它只做最基础的前缀匹配。比如注册 "/api/user"，实际会匹配所有以该字符串开头的请求（如 "/api/user/123?x=1"），但不会自动提取 123 作为 ID。这不是 bug，是设计使然：标准库刻意保持轻量。
常见错误现象：
– 用 http.HandleFunc("/user/:id", handler) 期望解析 :id，结果 404
– 在多个 HandleFunc 中注册重叠路径（如 "/api" 和 "/api/users"），后者永远收不到请求（因为前者已匹配）
- 注册顺序敏感：先注册的规则优先匹配，后注册的同前缀路径会被屏蔽
- 路径末尾斜杠影响匹配逻辑：
"/api"匹配/api、/api/、/api/x；而"/api/"只匹配以/api/开头的路径（不匹配/api） - 不区分 HTTP 方法：同一个路径下
GET、POST都进同一个 handler，需手动判断r.Method
想实现真路由？得换 http.ServeMux 或引入第三方库
标准 http.ServeMux 和 HandleFunc 是一对，能力有限。要支持 /:id、/users/{id:int}、中间件等，必须替换或封装。
- 直接用
http.ServeMux子类（不推荐）：它未导出关键字段，难以安全扩展 - 改用
gorilla/mux：router.HandleFunc("/users/{id:[0-9]+}", handler).Methods("GET")，支持正则约束和方法过滤 - 轻量替代选
chi：r.Get("/users/{id}", handler)，API 更简洁，自带中间件链支持 - 若坚持不用第三方，可手写路径前缀分发器：按路径段数或关键词（如
/api/v1/）做 switch 分流，但无法处理动态段
HandleFunc 的 handler 函数签名不能乱改
http.HandleFunc 要求第二个参数是 func(http.ResponseWriter, *http.Request) 类型。任何偏差都会编译失败。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“go语言免费学习笔记（深入）”；
典型错误：
– 忘记加 *http.Request 指针（写成 http.Request）→ 类型不匹配
– 尝试返回值（如 func(...) error）→ 编译报错 cannot use ... as http.HandlerFunc
- handler 内必须显式调用
w.WriteHeader(statusCode)，否则默认 200；写入响应体前若未设状态码，后续再调也无效 - 不要在 handler 里 recover panic：标准
http.ServeMux不捕获 panic，会导致整个 server 崩溃；需自己包装 handler 加 defer/recover - 注意并发安全：
http.Request和http.ResponseWriter对象仅在当前 handler 调用期间有效，不可跨 goroutine 传递
监听端口前务必检查地址绑定和错误处理
http.ListenAndServe(":8080", nil) 看似简单，但忽略错误会导致服务静默失败。
- 端口被占时返回
listen tcp :8080: bind: address already in use，但若没检查 err，程序直接退出，无日志 - 使用
"0.0.0.0:8080"表示监听所有接口；用"127.0.0.1:8080"则外部无法访问（Docker 容器内尤其容易踩坑） - HTTPS 需用
http.ListenAndServeTLS，且证书路径必须是文件系统路径，不能是嵌入的embed.FS内容（除非自行读取并传入tls.Config）
真正上线时，别直接裸跑 ListenAndServe。至少加一层错误打印：log.Fatal(http.ListenAndServe(":8080", nil))，否则连端口冲突都看不到。
